Edit

Share via

IAudioEndpointVolume::QueryHardwareSupport method (endpointvolume.h)

  • Article

The QueryHardwareSupport method queries the audio endpoint device for its hardware-supported functions.

Syntax

HRESULT QueryHardwareSupport(
  [out] DWORD *pdwHardwareSupportMask
);

Parameters

[out] pdwHardwareSupportMask

Pointer to a DWORD variable into which the method writes a hardware support mask that indicates the hardware capabilities of the audio endpoint device. The method can set the mask to 0 or to the bitwise-OR combination of one or more ENDPOINT_HARDWARE_SUPPORT_XXX constants.

Return value

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
E_POINTER
 Parameter pdwHardwareSupportMask is NULL.

Remarks

This method indicates whether the audio endpoint device implements the following functions in hardware:

  • Volume control
  • Mute control
  • Peak meter
The system automatically substitutes a software implementation for any function in the preceding list that the endpoint device does not implement in hardware.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header endpointvolume.h

See also

IAudioEndpointVolume Interface