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

GetSetTargetProperty descriptor typeProperty value type

Yes

No

Filter

KSPROPERTY+ULONG

KSCOMPONENTID

 

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)

See also

KSPROPERTY
KSCOMPONENTID
KSPROPERTY_SYSAUDIO_DEVICE_COUNT

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft