Metodo ISpatialAudioClient2::GetMaxFrameCountForCategory (spatialaudioclient.h)

Articolo
03/02/2024

Ottiene il numero massimo di fotogrammi supportato per ogni passaggio di elaborazione.

Sintassi

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

Parametri

[in] category

Il AUDIO_STREAM_CATEGORY (audiosessiontypes.h) del flusso audio per cui viene eseguita una query sul supporto.

[in] offloadEnabled

Valore booleano che specifica se il conteggio dei fotogrammi restituito deve essere calcolato con il supporto di offload audio considerato. Se questo flag è impostato su true, il conteggio dei fotogrammi restituito è quello che sarebbe se il flusso viene attivato per la modalità offload. Tuttavia, se questo flag è impostato su true, ma l'endpoint audio non supporta la modalità offload, il flag non ha alcun effetto. Usare ISpatialAudioClient2::IsOffloadCapable per verificare se la modalità offload è supportata.

[in] objectFormat

Puntatore a una struttura WAVEFORMATEX (mmeapi.h) che specifica il formato del flusso audio per cui viene eseguita una query sul supporto.

[out] frameCountPerBuffer

Riceve un puntatore a un INT32 che indica il numero massimo di fotogrammi supportati per il dispositivo audio e i parametri di input specificati.

Valore restituito

HRESULT, inclusi i valori seguenti.

Valore	Descrizione
S_OK	Operazione riuscita
AUDCLNT_E_DEVICE_INVALIDATED	Il dispositivo audio associato al client audio è stato invalidato.

Commenti

Il valore restituito da questo metodo può essere usato per allocare il buffer di origine. Questo valore cambierà se la frequenza dell'endpoint cambia. Il chiamante deve specificare gli stessi valori AUDIO_STREAM_CATEGORY e WAVEFORMATEX che verranno utilizzati durante la creazione del flusso. Il parametro offloadEnabled deve essere impostato su TRUE se il flusso verrà creato con il flag SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Build 22000
Intestazione	spatialaudioclient.h

Condividi tramite