ISpatialAudioClient2::GetMaxFrameCountForCategory-Methode (spatialaudioclient.h)

Artikel
03/02/2024

Ruft die maximale unterstützte Frameanzahl pro Verarbeitungsdurchlauf ab.

Syntax

HRESULT GetMaxFrameCountForCategory(
  [in]  AUDIO_STREAM_CATEGORY category,
  [in]  BOOL                  offloadEnabled,
  [in]  const WAVEFORMATEX    *objectFormat,
  [out] UINT32                *frameCountPerBuffer
);

Parameter

[in] category

Die AUDIO_STREAM_CATEGORY (audiosessiontypes.h) des Audiostreams , für den die Unterstützung abgefragt wird.

[in] offloadEnabled

Ein boolescher Wert, der angibt, ob die zurückgegebene Frameanzahl unter Berücksichtigung der Audioauslagerungsunterstützung berechnet werden soll. Wenn dieses Flag auf TRUE festgelegt ist, entspricht die zurückgegebene Frameanzahl, wenn der Stream für den Auslagerungsmodus aktiviert wird. Wenn dieses Flag jedoch auf true festgelegt ist, der Audioendpunkt den Auslagerungsmodus jedoch nicht unterstützt, hat das Flag keine Auswirkung. Verwenden Sie ISpatialAudioClient2::IsOffloadCapable , um zu überprüfen, ob der Auslagerungsmodus unterstützt wird.

[in] objectFormat

Ein Zeiger auf eine WAVEFORMATEX-Struktur (mmeapi.h), die das Format des Audiostreams angibt, für den die Unterstützung abgefragt wird.

[out] frameCountPerBuffer

Empfängt einen Zeiger auf einen INT32 , der die maximale unterstützte Frameanzahl für das Audiogerät und die angegebenen Eingabeparameter angibt.

Rückgabewert

Ein HRESULT mit den folgenden Werten.

Wert	BESCHREIBUNG
S_OK	Erfolg
AUDCLNT_E_DEVICE_INVALIDATED	Das dem Audioclient zugeordnete Audiogerät wurde ungültig gemacht.

Hinweise

Der von dieser Methode zurückgegebene Wert kann zum Zuweisen des Quellpuffers verwendet werden. Dieser Wert ändert sich, wenn sich der Endpunktrhythmus ändert. Der Aufrufer muss dieselben werte AUDIO_STREAM_CATEGORY und WAVEFORMATEX angeben, die beim Erstellen des Datenstroms verwendet werden. Der offloadEnabled-Parameter muss auf TRUE festgelegt werden, wenn der Stream mit dem Flag SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD erstellt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Build 22000
Kopfzeile	spatialaudioclient.h

Share via