2 * COPYRIGHT: See COPYING in the top level directory
3 * PROJECT: ReactOS Kernel Streaming
4 * FILE: drivers/wdm/audio/legacy/wdmaud/mmixer.c
5 * PURPOSE: WDM Legacy Mixer
6 * PROGRAMMER: Johannes Anderwald
12 PVOID
Alloc(ULONG NumBytes
);
13 MIXER_STATUS
Close(HANDLE hDevice
);
14 VOID
Free(PVOID Block
);
15 VOID
Copy(PVOID Src
, PVOID Dst
, ULONG NumBytes
);
16 MIXER_STATUS
Open(IN LPWSTR DevicePath
, OUT PHANDLE hDevice
);
17 MIXER_STATUS
Control(IN HANDLE hMixer
, IN ULONG dwIoControlCode
, IN PVOID lpInBuffer
, IN ULONG nInBufferSize
, OUT PVOID lpOutBuffer
, ULONG nOutBufferSize
, PULONG lpBytesReturned
);
18 MIXER_STATUS
Enum(IN PVOID EnumContext
, IN ULONG DeviceIndex
, OUT LPWSTR
* DeviceName
, OUT PHANDLE OutHandle
, OUT PHANDLE OutKey
);
19 MIXER_STATUS
OpenKey(IN HANDLE hKey
, IN LPWSTR SubKey
, IN ULONG DesiredAccess
, OUT PHANDLE OutKey
);
20 MIXER_STATUS
CloseKey(IN HANDLE hKey
);
21 MIXER_STATUS
QueryKeyValue(IN HANDLE hKey
, IN LPWSTR KeyName
, OUT PVOID
* ResultBuffer
, OUT PULONG ResultLength
, OUT PULONG KeyType
);
22 PVOID
AllocEventData(IN ULONG ExtraSize
);
23 VOID
FreeEventData(IN PVOID EventData
);
25 MIXER_CONTEXT MixerContext
=
27 sizeof(MIXER_CONTEXT
),
42 GUID CategoryGuid
= {STATIC_KSCATEGORY_AUDIO
};
48 OUT PVOID
* ResultBuffer
,
49 OUT PULONG ResultLength
,
53 UNICODE_STRING KeyName
;
55 PKEY_VALUE_PARTIAL_INFORMATION PartialInformation
;
57 /* initialize key name */
58 RtlInitUnicodeString(&KeyName
, lpKeyName
);
60 /* now query MatchingDeviceId key */
61 Status
= ZwQueryValueKey(hKey
, &KeyName
, KeyValuePartialInformation
, NULL
, 0, &Length
);
63 /* check for success */
64 if (Status
!= STATUS_BUFFER_TOO_SMALL
)
65 return MM_STATUS_UNSUCCESSFUL
;
67 /* allocate a buffer for key data */
68 PartialInformation
= AllocateItem(NonPagedPool
, Length
);
70 if (!PartialInformation
)
71 return MM_STATUS_NO_MEMORY
;
74 /* now query MatchingDeviceId key */
75 Status
= ZwQueryValueKey(hKey
, &KeyName
, KeyValuePartialInformation
, PartialInformation
, Length
, &Length
);
77 /* check for success */
78 if (!NT_SUCCESS(Status
))
80 FreeItem(PartialInformation
);
81 return MM_STATUS_UNSUCCESSFUL
;
87 *KeyType
= PartialInformation
->Type
;
92 /* return data length */
93 *ResultLength
= PartialInformation
->DataLength
;
96 *ResultBuffer
= AllocateItem(NonPagedPool
, PartialInformation
->DataLength
);
99 /* not enough memory */
100 FreeItem(PartialInformation
);
101 return MM_STATUS_NO_MEMORY
;
105 RtlMoveMemory(*ResultBuffer
, PartialInformation
->Data
, PartialInformation
->DataLength
);
108 FreeItem(PartialInformation
);
110 return MM_STATUS_SUCCESS
;
116 IN LPWSTR lpSubKeyName
,
117 IN ULONG DesiredAccess
,
120 OBJECT_ATTRIBUTES ObjectAttributes
;
121 UNICODE_STRING SubKeyName
;
124 /* initialize sub key name */
125 RtlInitUnicodeString(&SubKeyName
, lpSubKeyName
);
127 /* initialize key attributes */
128 InitializeObjectAttributes(&ObjectAttributes
, &SubKeyName
, OBJ_CASE_INSENSITIVE
| OBJ_OPENIF
, hKey
, NULL
);
131 Status
= ZwOpenKey(OutKey
, DesiredAccess
, &ObjectAttributes
);
133 if (NT_SUCCESS(Status
))
134 return MM_STATUS_SUCCESS
;
136 return MM_STATUS_UNSUCCESSFUL
;
143 if (ZwClose(hKey
) == STATUS_SUCCESS
)
144 return MM_STATUS_SUCCESS
;
146 return MM_STATUS_UNSUCCESSFUL
;
150 PVOID
Alloc(ULONG NumBytes
)
152 return AllocateItem(NonPagedPool
, NumBytes
);
156 Close(HANDLE hDevice
)
158 if (ZwClose(hDevice
) == STATUS_SUCCESS
)
159 return MM_STATUS_SUCCESS
;
161 return MM_STATUS_UNSUCCESSFUL
;
171 Copy(PVOID Src
, PVOID Dst
, ULONG NumBytes
)
173 RtlMoveMemory(Src
, Dst
, NumBytes
);
178 IN LPWSTR DevicePath
,
181 if (WdmAudOpenSysAudioDevice(DevicePath
, hDevice
) == STATUS_SUCCESS
)
182 return MM_STATUS_SUCCESS
;
184 return MM_STATUS_UNSUCCESSFUL
;
190 IN ULONG dwIoControlCode
,
192 IN ULONG nInBufferSize
,
193 OUT PVOID lpOutBuffer
,
194 ULONG nOutBufferSize
,
195 PULONG lpBytesReturned
)
198 PFILE_OBJECT FileObject
;
200 /* get file object */
201 Status
= ObReferenceObjectByHandle(hMixer
, GENERIC_READ
| GENERIC_WRITE
, IoFileObjectType
, KernelMode
, (PVOID
*)&FileObject
, NULL
);
202 if (!NT_SUCCESS(Status
))
204 DPRINT("failed to reference %p with %lx\n", hMixer
, Status
);
205 return MM_STATUS_UNSUCCESSFUL
;
208 /* perform request */
209 Status
= KsSynchronousIoControlDevice(FileObject
, KernelMode
, dwIoControlCode
, lpInBuffer
, nInBufferSize
, lpOutBuffer
, nOutBufferSize
, lpBytesReturned
);
211 /* release object reference */
212 ObDereferenceObject(FileObject
);
214 if (Status
== STATUS_MORE_ENTRIES
|| Status
== STATUS_BUFFER_OVERFLOW
|| Status
== STATUS_BUFFER_TOO_SMALL
)
216 /* more data is available */
217 return MM_STATUS_MORE_ENTRIES
;
219 else if (Status
== STATUS_SUCCESS
)
221 /* operation succeeded */
222 return MM_STATUS_SUCCESS
;
226 DPRINT("Failed with %lx\n", Status
);
227 return MM_STATUS_UNSUCCESSFUL
;
233 IN PVOID EnumContext
,
234 IN ULONG DeviceIndex
,
235 OUT LPWSTR
* DeviceName
,
236 OUT PHANDLE OutHandle
,
239 PDEVICE_OBJECT DeviceObject
;
242 UNICODE_STRING KeyName
;
244 /* get enumeration context */
245 DeviceObject
= (PDEVICE_OBJECT
)EnumContext
;
247 /* get device count */
248 DeviceCount
= GetSysAudioDeviceCount(DeviceObject
);
250 if (DeviceIndex
>= DeviceCount
)
252 /* no more devices */
253 return MM_STATUS_NO_MORE_DEVICES
;
256 /* get device name */
257 Status
= GetSysAudioDevicePnpName(DeviceObject
, DeviceIndex
, DeviceName
);
259 if (!NT_SUCCESS(Status
))
261 /* failed to retrieve device name */
262 return MM_STATUS_UNSUCCESSFUL
;
265 /* intialize key name */
266 RtlInitUnicodeString(&KeyName
, *DeviceName
);
268 /* open device interface key */
269 Status
= IoOpenDeviceInterfaceRegistryKey(&KeyName
, GENERIC_READ
| GENERIC_WRITE
, OutKey
);
271 if (!NT_SUCCESS(Status
))
273 /* failed to open key */
274 DPRINT("IoOpenDeviceInterfaceRegistryKey failed with %lx\n", Status
);
275 FreeItem(*DeviceName
);
276 return MM_STATUS_UNSUCCESSFUL
;
280 /* open device handle */
281 Status
= OpenDevice(*DeviceName
, OutHandle
, NULL
);
282 if (!NT_SUCCESS(Status
))
284 /* failed to open device */
285 return MM_STATUS_UNSUCCESSFUL
;
288 return MM_STATUS_SUCCESS
;
295 PKSEVENTDATA Data
= (PKSEVENTDATA
)AllocateItem(NonPagedPool
, sizeof(KSEVENTDATA
) + ExtraSize
);
299 Data
->EventObject
.Event
= AllocateItem(NonPagedPool
, sizeof(KEVENT
));
300 if (!Data
->EventHandle
.Event
)
306 KeInitializeEvent(Data
->EventObject
.Event
, NotificationEvent
, FALSE
);
308 Data
->NotificationType
= KSEVENTF_EVENT_HANDLE
;
313 FreeEventData(IN PVOID EventData
)
315 PKSEVENTDATA Data
= (PKSEVENTDATA
)EventData
;
317 FreeItem(Data
->EventHandle
.Event
);
322 WdmAudMixerInitialize(
323 IN PDEVICE_OBJECT DeviceObject
)
327 /* initialize the mixer library */
328 Status
= MMixerInitialize(&MixerContext
, Enum
, (PVOID
)DeviceObject
);
330 if (Status
!= MM_STATUS_SUCCESS
)
332 /* failed to initialize mmixer library */
333 DPRINT("MMixerInitialize failed with %lx\n", Status
);
340 WdmAudMixerCapabilities(
341 IN PDEVICE_OBJECT DeviceObject
,
342 IN PWDMAUD_DEVICE_INFO DeviceInfo
,
343 IN PWDMAUD_CLIENT ClientInfo
,
344 IN PWDMAUD_DEVICE_EXTENSION DeviceExtension
)
346 if (MMixerGetCapabilities(&MixerContext
, DeviceInfo
->DeviceIndex
, &DeviceInfo
->u
.MixCaps
) == MM_STATUS_SUCCESS
)
347 return STATUS_SUCCESS
;
349 return STATUS_INVALID_PARAMETER
;
353 WdmAudControlOpenMixer(
354 IN PDEVICE_OBJECT DeviceObject
,
356 IN PWDMAUD_DEVICE_INFO DeviceInfo
,
357 IN PWDMAUD_CLIENT ClientInfo
)
360 PWDMAUD_HANDLE Handles
;
361 PWDMAUD_DEVICE_EXTENSION DeviceExtension
;
363 PKEVENT EventObject
= NULL
;
365 DPRINT("WdmAudControlOpenMixer\n");
367 DeviceExtension
= (PWDMAUD_DEVICE_EXTENSION
)DeviceObject
->DeviceExtension
;
369 if (DeviceInfo
->u
.hNotifyEvent
)
371 Status
= ObReferenceObjectByHandle(DeviceInfo
->u
.hNotifyEvent
, EVENT_MODIFY_STATE
, ExEventObjectType
, UserMode
, (LPVOID
*)&EventObject
, NULL
);
373 if (!NT_SUCCESS(Status
))
375 DPRINT1("Invalid notify event passed %p from client %p\n", DeviceInfo
->u
.hNotifyEvent
, ClientInfo
);
377 return SetIrpIoStatus(Irp
, STATUS_UNSUCCESSFUL
, 0);
381 if (MMixerOpen(&MixerContext
, DeviceInfo
->DeviceIndex
, EventObject
, NULL
/* FIXME */, &hMixer
) != MM_STATUS_SUCCESS
)
383 ObDereferenceObject(EventObject
);
384 DPRINT1("Failed to open mixer\n");
385 return SetIrpIoStatus(Irp
, STATUS_UNSUCCESSFUL
, 0);
389 Handles
= AllocateItem(NonPagedPool
, sizeof(WDMAUD_HANDLE
) * (ClientInfo
->NumPins
+1));
393 if (ClientInfo
->NumPins
)
395 RtlMoveMemory(Handles
, ClientInfo
->hPins
, sizeof(WDMAUD_HANDLE
) * ClientInfo
->NumPins
);
396 FreeItem(ClientInfo
->hPins
);
399 ClientInfo
->hPins
= Handles
;
400 ClientInfo
->hPins
[ClientInfo
->NumPins
].Handle
= hMixer
;
401 ClientInfo
->hPins
[ClientInfo
->NumPins
].Type
= MIXER_DEVICE_TYPE
;
402 ClientInfo
->hPins
[ClientInfo
->NumPins
].NotifyEvent
= EventObject
;
403 ClientInfo
->NumPins
++;
407 ObDereferenceObject(EventObject
);
408 return SetIrpIoStatus(Irp
, STATUS_UNSUCCESSFUL
, sizeof(WDMAUD_DEVICE_INFO
));
411 DeviceInfo
->hDevice
= hMixer
;
413 return SetIrpIoStatus(Irp
, STATUS_SUCCESS
, sizeof(WDMAUD_DEVICE_INFO
));
418 WdmAudGetControlDetails(
419 IN PDEVICE_OBJECT DeviceObject
,
421 IN PWDMAUD_DEVICE_INFO DeviceInfo
,
422 IN PWDMAUD_CLIENT ClientInfo
)
426 /* clear hmixer type flag */
427 DeviceInfo
->Flags
&= ~MIXER_OBJECTF_HMIXER
;
429 /* query mmixer library */
430 Status
= MMixerGetControlDetails(&MixerContext
, DeviceInfo
->hDevice
, DeviceInfo
->Flags
, &DeviceInfo
->u
.MixDetails
);
432 if (Status
== MM_STATUS_SUCCESS
)
433 return SetIrpIoStatus(Irp
, STATUS_SUCCESS
, sizeof(WDMAUD_DEVICE_INFO
));
435 return SetIrpIoStatus(Irp
, STATUS_UNSUCCESSFUL
, sizeof(WDMAUD_DEVICE_INFO
));
441 IN PDEVICE_OBJECT DeviceObject
,
443 IN PWDMAUD_DEVICE_INFO DeviceInfo
,
444 IN PWDMAUD_CLIENT ClientInfo
)
448 /* clear hmixer type flag */
449 DeviceInfo
->Flags
&= ~MIXER_OBJECTF_HMIXER
;
451 /* query mixer library */
452 Status
= MMixerGetLineInfo(&MixerContext
, DeviceInfo
->hDevice
, DeviceInfo
->Flags
, &DeviceInfo
->u
.MixLine
);
454 if (Status
== MM_STATUS_SUCCESS
)
455 return SetIrpIoStatus(Irp
, STATUS_SUCCESS
, sizeof(WDMAUD_DEVICE_INFO
));
457 return SetIrpIoStatus(Irp
, STATUS_UNSUCCESSFUL
, sizeof(WDMAUD_DEVICE_INFO
));
462 WdmAudGetLineControls(
463 IN PDEVICE_OBJECT DeviceObject
,
465 IN PWDMAUD_DEVICE_INFO DeviceInfo
,
466 IN PWDMAUD_CLIENT ClientInfo
)
470 /* clear hmixer type flag */
471 DeviceInfo
->Flags
&= ~MIXER_OBJECTF_HMIXER
;
473 /* query mixer library */
474 Status
= MMixerGetLineControls(&MixerContext
, DeviceInfo
->hDevice
, DeviceInfo
->Flags
, &DeviceInfo
->u
.MixControls
);
476 if (Status
== MM_STATUS_SUCCESS
)
477 return SetIrpIoStatus(Irp
, STATUS_SUCCESS
, sizeof(WDMAUD_DEVICE_INFO
));
479 return SetIrpIoStatus(Irp
, STATUS_UNSUCCESSFUL
, sizeof(WDMAUD_DEVICE_INFO
));
486 WdmAudSetControlDetails(
487 IN PDEVICE_OBJECT DeviceObject
,
489 IN PWDMAUD_DEVICE_INFO DeviceInfo
,
490 IN PWDMAUD_CLIENT ClientInfo
)
494 /* clear hmixer type flag */
495 DeviceInfo
->Flags
&= ~MIXER_OBJECTF_HMIXER
;
497 /* query mixer library */
498 Status
= MMixerSetControlDetails(&MixerContext
, DeviceInfo
->hDevice
, DeviceInfo
->Flags
, &DeviceInfo
->u
.MixDetails
);
500 if (Status
== MM_STATUS_SUCCESS
)
501 return SetIrpIoStatus(Irp
, STATUS_SUCCESS
, sizeof(WDMAUD_DEVICE_INFO
));
503 return SetIrpIoStatus(Irp
, STATUS_UNSUCCESSFUL
, sizeof(WDMAUD_DEVICE_INFO
));
509 IN PDEVICE_OBJECT DeviceObject
,
511 IN PWDMAUD_DEVICE_INFO DeviceInfo
,
512 IN PWDMAUD_CLIENT ClientInfo
)
515 return SetIrpIoStatus(Irp
, STATUS_UNSUCCESSFUL
, sizeof(WDMAUD_DEVICE_INFO
));
519 WdmAudGetMixerDeviceCount()
521 return MMixerGetCount(&MixerContext
);
525 WdmAudGetWaveInDeviceCount()
527 return MMixerGetWaveInCount(&MixerContext
);
531 WdmAudGetWaveOutDeviceCount()
533 return MMixerGetWaveOutCount(&MixerContext
);
537 WdmAudGetMixerPnpNameByIndex(
538 IN ULONG DeviceIndex
,
542 return STATUS_NOT_IMPLEMENTED
;
546 WdmAudGetPnpNameByIndexAndType(
547 IN ULONG DeviceIndex
,
548 IN SOUND_DEVICE_TYPE DeviceType
,
549 OUT LPWSTR
*DevicePath
)
551 if (MMixerGetWaveDevicePath(&MixerContext
, DeviceType
== WAVE_IN_DEVICE_TYPE
, DeviceIndex
, DevicePath
) == MM_STATUS_SUCCESS
)
552 return STATUS_SUCCESS
;
554 return STATUS_UNSUCCESSFUL
;
558 WdmAudWaveCapabilities(
559 IN PDEVICE_OBJECT DeviceObject
,
560 IN PWDMAUD_DEVICE_INFO DeviceInfo
,
561 IN PWDMAUD_CLIENT ClientInfo
,
562 IN PWDMAUD_DEVICE_EXTENSION DeviceExtension
)
566 if (DeviceInfo
->DeviceType
== WAVE_IN_DEVICE_TYPE
)
568 /* get capabilities */
569 Status
= MMixerWaveInCapabilities(&MixerContext
, DeviceInfo
->DeviceIndex
, &DeviceInfo
->u
.WaveInCaps
);
571 else if (DeviceInfo
->DeviceType
== WAVE_OUT_DEVICE_TYPE
)
573 /* get capabilities */
574 Status
= MMixerWaveOutCapabilities(&MixerContext
, DeviceInfo
->DeviceIndex
, &DeviceInfo
->u
.WaveOutCaps
);
579 return STATUS_UNSUCCESSFUL
;
582 if (Status
== MM_STATUS_SUCCESS
)
583 return STATUS_SUCCESS
;
585 return STATUS_UNSUCCESSFUL
;
592 IN ULONG VirtualDeviceId
,
595 IN PKSPIN_CONNECT PinConnect
,
596 IN ACCESS_MASK DesiredAccess
,
597 OUT PHANDLE PinHandle
)
600 SYSAUDIO_INSTANCE_INFO InstanceInfo
;
603 PPIN_CREATE_CONTEXT Context
= (PPIN_CREATE_CONTEXT
)Ctx
;
605 /* setup property request */
606 InstanceInfo
.Property
.Set
= KSPROPSETID_Sysaudio
;
607 InstanceInfo
.Property
.Id
= KSPROPERTY_SYSAUDIO_INSTANCE_INFO
;
608 InstanceInfo
.Property
.Flags
= KSPROPERTY_TYPE_SET
;
609 InstanceInfo
.Flags
= 0;
610 InstanceInfo
.DeviceNumber
= VirtualDeviceId
;
612 /* attach to virtual device */
613 Status
= KsSynchronousIoControlDevice(Context
->DeviceExtension
->FileObject
, KernelMode
, IOCTL_KS_PROPERTY
, (PVOID
)&InstanceInfo
, sizeof(SYSAUDIO_INSTANCE_INFO
), NULL
, 0, &BytesReturned
);
615 if (!NT_SUCCESS(Status
))
616 return MM_STATUS_UNSUCCESSFUL
;
618 /* close existing pin */
619 FreeIndex
= ClosePin(Context
->ClientInfo
, VirtualDeviceId
, PinId
, Context
->DeviceType
);
621 /* now create the pin */
622 Status
= KsCreatePin(Context
->DeviceExtension
->hSysAudio
, PinConnect
, DesiredAccess
, PinHandle
);
624 /* check for success */
625 if (!NT_SUCCESS(Status
))
626 return MM_STATUS_UNSUCCESSFUL
;
628 /* store the handle */
629 Status
= InsertPinHandle(Context
->ClientInfo
, VirtualDeviceId
, PinId
, Context
->DeviceType
, *PinHandle
, FreeIndex
);
630 if (!NT_SUCCESS(Status
))
632 /* failed to insert handle */
634 return MM_STATUS_UNSUCCESSFUL
;
637 return MM_STATUS_SUCCESS
;
641 WdmAudControlOpenWave(
642 IN PDEVICE_OBJECT DeviceObject
,
644 IN PWDMAUD_DEVICE_INFO DeviceInfo
,
645 IN PWDMAUD_CLIENT ClientInfo
)
648 PIN_CREATE_CONTEXT Context
;
650 Context
.ClientInfo
= ClientInfo
;
651 Context
.DeviceExtension
= (PWDMAUD_DEVICE_EXTENSION
)DeviceObject
->DeviceExtension
;
652 Context
.DeviceType
= DeviceInfo
->DeviceType
;
654 Status
= MMixerOpenWave(&MixerContext
, DeviceInfo
->DeviceIndex
, DeviceInfo
->DeviceType
== WAVE_IN_DEVICE_TYPE
, &DeviceInfo
->u
.WaveFormatEx
, CreatePinCallback
, &Context
, &DeviceInfo
->hDevice
);
656 if (Status
== MM_STATUS_SUCCESS
)
657 return SetIrpIoStatus(Irp
, STATUS_SUCCESS
, sizeof(WDMAUD_DEVICE_INFO
));
659 return SetIrpIoStatus(Irp
, STATUS_NOT_SUPPORTED
, sizeof(WDMAUD_DEVICE_INFO
));