IAudioMeterInformation::QueryHardwareSupport method
The QueryHardwareSupport method queries the audio endpoint device for its hardware-supported functions.
Syntax
HRESULT QueryHardwareSupport( [out] DWORD *pdwHardwareSupportMask );
Parameters
- pdwHardwareSupportMask [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. 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 |
|---|---|
|
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 devices does not implement in hardware.
Requirements
|
Minimum supported client |
Windows Vista [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps | Windows Store apps] |
|
Header |
|
See also