IAudioClient2::GetBufferSizeLimits-Methode (audioclient.h)

  • Artikel

Die GetBufferSizeLimits-Methode gibt die Puffergrößenlimits der Hardwareaudio-Engine in Einheiten von 100 Nanosekunden zurück.

Syntax

HRESULT GetBufferSizeLimits(
  [in]  const WAVEFORMATEX *pFormat,
  [in]  BOOL               bEventDriven,
  [out] REFERENCE_TIME     *phnsMinBufferDuration,
  [out] REFERENCE_TIME     *phnsMaxBufferDuration
);

Parameter

[in] pFormat

Ein Zeiger auf das Zielformat, das nach dem Puffergrößenlimit abgefragt wird.

[in] bEventDriven

Boolescher Wert, um anzugeben, ob der Stream ereignisgesteuert sein kann.

[out] phnsMinBufferDuration

Gibt einen Zeiger auf die minimale Puffergröße (in Einheiten von 100 Nanosekunden) zurück, die erforderlich ist, damit die zugrunde liegende Hardwareaudio-Engine mit dem im pFormat-Parameter angegebenen Format ohne häufige Audio-Störungen arbeiten kann.

[out] phnsMaxBufferDuration

Gibt einen Zeiger auf die maximale Puffergröße (in Einheiten von 100 Nanosekunden) zurück, die die zugrunde liegende Hardwareaudio-Engine für das im pFormat-Parameter angegebene Format unterstützen kann.

Rückgabewert

Die GetBufferSizeLimits-Methode gibt S_OK zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Sie kann beispielsweise AUDCLNT_E_DEVICE_INVALIDATED zurückgeben, wenn das Gerät entfernt wurde und die Methode aufgerufen wird.

Hinweise

Die GetBufferSizeLimits-Methode ist eine gerätebezogene Methode
und erfordert keine vorherige Audiostreaminitialisierung.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile audioclient.h

Weitere Informationen

IAudioClient2