KSPROPERTY_SYSAUDIO_COMPONENT_ID
The KSPROPERTY_SYSAUDIO_COMPONENT_ID property retrieves the component ID from the wave-rendering device that the specified virtual audio device uses.
Usage Summary Table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
Yes |
No |
Filter |
KSPROPERTY+ULONG |
The property descriptor (instance data) is a structure of type KSPROPERTY followed by a ULONG variable containing a device ID that identifies a virtual audio device. If SysAudio enumerates n virtual audio devices (see KSPROPERTY_SYSAUDIO_DEVICE_COUNT), then valid device IDs range from 0 to n-1.
The property value (operation data) is a structure of type KSCOMPONENTID that specifies the manufacturer, product, and other hardware-specific information about the wave-rendering device that is used by the specified virtual audio device.
Return Value
A KSPROPERTY_SYSAUDIO_COMPONENT_ID property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.
Remarks
DirectSound does not communicate directly with the miniport driver for the audio hardware that underlies each of SysAudio's virtual audio devices. Thus, DirectSound is unable to query the wave-rendering device directly for its component-ID information. The KSPROPERTY_SYSAUDIO_COMPONENT_ID property provides a means for DirectSound to obtain this information indirectly through SysAudio.
Requirements
Header |
Ksmedia.h (include Ksmedia.h) |