IAudioMeterInformation::QueryHardwareSupport-Methode (endpointvolume.h)

  • Artikel

Die QueryHardwareSupport-Methode fragt das Audioendpunktgerät nach seinen hardwareunterstützten Funktionen ab.

Syntax

HRESULT QueryHardwareSupport(
  [out] DWORD *pdwHardwareSupportMask
);

Parameter

[out] pdwHardwareSupportMask

Zeiger auf eine DWORD-Variable , in die die Methode eine Hardwareunterstützungsmaske schreibt, die die Hardwarefunktionen des Audioendpunktgeräts angibt. Die -Methode kann die Maske auf 0 oder auf die bitweise OR-Kombination einer oder mehrerer ENDPOINT_HARDWARE_SUPPORT_XXX Konstanten festlegen.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_POINTER
 Der Parameter pdwHardwareSupportMask ist NULL.

Hinweise

Diese Methode gibt an, ob das Audioendpunktgerät die folgenden Funktionen in der Hardware implementiert:

  • Lautstärkeregelung
  • Stummschaltsteuerelement
  • Spitzenzähler
Das System ersetzt automatisch eine Softwareimplementierung für jede Funktion in der vorherigen Liste, die die Endpunktgeräte nicht in Hardware implementieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile endpointvolume.h

Weitere Informationen

IAudioMeterInformation-Schnittstelle