IAudioEndpointVolume::GetVolumeStepInfo-Methode (endpointvolume.h)

  • Artikel

Die GetVolumeStepInfo-Methode ruft Informationen zum aktuellen Schritt im Volumebereich ab.

Syntax

HRESULT GetVolumeStepInfo(
  [out] UINT *pnStep,
  [out] UINT *pnStepCount
);

Parameter

[out] pnStep

Zeiger auf eine UINT-Variable , in die die -Methode den aktuellen Schrittindex schreibt. Dieser Index ist ein Wert im Bereich von 0 bis *pStepCount– 1, wobei 0 die minimale Volumeebene und *pStepCount– 1 die maximale Ebene darstellt.

[out] pnStepCount

Zeiger auf eine UINT-Variable , in die die Methode die Anzahl der Schritte im Volumebereich schreibt. Diese Zahl bleibt für die Lebensdauer der IAudioEndpointVolume-Schnittstelle instance konstant.

Rückgabewert

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

Rückgabecode Beschreibung
E_POINTER
 Die Parameter pnStep und pnStepCount sind beide NULL.

Hinweise

Diese Methode stellt den Lautstärkepegel des Audiostreams dar, der das Audioendpunktgerät als Index oder "Schritt" in einem Bereich diskreter Lautstärkestufen eingibt oder verlässt. Der Ausgabewert *pnStepCount ist die Anzahl der Schritte im Bereich. Der Ausgabewert *pnStep ist der Schrittindex der aktuellen Volumeebene. Wenn die Anzahl der Schritte n = *pnStepCount ist, kann der Schrittindex *pnStep Werte von 0 (Minimales Volumen) bis n – 1 (maximales Volumen) annehmen.

Im Bereich von 0 bis n – 1 stellen aufeinander folgende Intervalle zwischen benachbarten Schritten nicht notwendigerweise gleichmäßige Volumenschritte in linearen Signalamplituden oder Dezibel dar. In Windows Vista definiert GetVolumeStepInfo die Beziehung von Index zur Lautstärkeebene (Signalamplitude), um eine audioverknüngte Kurve zu sein. Beachten Sie, dass sich die Form der Kurve in zukünftigen Versionen von Windows ändern kann. Weitere Informationen zu Audioverknüngungskurven finden Sie unter Audioverknen von Lautstärkesteuerungen.

Audioanwendungen können die Methoden IAudioEndpointVolume::VolumeStepUp und IAudioEndpointVolume::VolumeStepDown aufrufen, um die Volumeebene um ein Intervall zu erhöhen oder zu verringern. Bei beiden Methoden wird zunächst der idealisierte Lautstärkepegel berechnet, der dem nächsten Punkt auf der audioverkneten Kurve entspricht. Als Nächstes wählt die Methode die Endpunktvolumeeinstellung aus, die die beste Annäherung an die idealisierte Ebene darstellt. Um den Bereich und die Granularität der Endpunktvolumeeinstellungen abzurufen, rufen Sie die IEndpointVolume::GetVolumeRange-Methode auf. Wenn das Audioendpunktgerät eine Hardwarelautstärkeregelung implementiert, beschreibt GetVolumeRange die HardwarevolumeRange-Einstellungen . Andernfalls implementiert die EndpointVolume-API die Endpunktvolume-Steuerung in der Software, und GetVolumeRange beschreibt die Volumeeinstellungen des von der Software implementierten Steuerelements.

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

IAudioEndpointVolume-Schnittstelle

IAudioEndpointVolume::VolumeStepDown

IAudioEndpointVolume::VolumeStepUp