IAudioEndpointVolume::QueryHardwareSupport Method

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

Syntax

public:
HRESULT QueryHardwareSupport(
         DWORD *pdwHardwareSupportMask
)  

Parameters

pdwHardwareSupportMask
Type: DWORD *

[out] Pointer to a DWORD variable into which the method writes a hardware support mask that indicates the hardware capabilities of the audio endpoint device:

Constant/value Description
ENDPOINT_HARDWARE_SUPPORT_VOLUME 0x00000001 The audio endpoint device supports a hardware volume control.

Return value

Type: HRESULT 

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:

Requirements

Header: Declared in endpointvolume.h.

Library: Use MMDevApi.lib.

See also

IAudioEndpointVolume

IAudioEndpointVolume Members