Metodo IAudioClient3::GetSharedModeEnginePeriod (audioclient.h)

Restituisce l'intervallo di periodicità supportato dal motore per il formato di flusso specificato. La periodicità del motore è la frequenza con cui il motore riattiva un client audio basato su eventi per trasferire dati audio da o verso il motore. I valori restituiti dipendono dalle caratteristiche del client audio, come specificato tramite una chiamata precedente a IAudioClient2::SetClientProperties.

Sintassi

HRESULT GetSharedModeEnginePeriod(
  [in]  const WAVEFORMATEX *pFormat,
  [out] UINT32             *pDefaultPeriodInFrames,
  [out] UINT32             *pFundamentalPeriodInFrames,
  [out] UINT32             *pMinPeriodInFrames,
  [out] UINT32             *pMaxPeriodInFrames
);

Parametri

[in] pFormat

Tipo: const WAVEFORMATEX*

Formato del flusso per il quale vengono eseguite query sulle periodicità supportate.

[out] pDefaultPeriodInFrames

Tipo: UINT32*

Periodo predefinito con cui il motore riattiva il client per il trasferimento di campioni audio

[out] pFundamentalPeriodInFrames

Tipo: UINT32*

Periodo fondamentale con cui il motore riattiva il client per il trasferimento di campioni audio. Quando si imposta la periodicità del motore audio, è necessario usare un multiplo integrale di questo valore.

[out] pMinPeriodInFrames

Tipo: UINT32*

Periodo più breve, in fotogrammi audio, con cui il motore audio riattiva il client per il trasferimento di campioni audio.

[out] pMaxPeriodInFrames

Tipo: UINT32*

Periodo più lungo, in fotogrammi audio, con cui il motore audio riattiva il client per il trasferimento di campioni audio.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce S_OK per indicare che è stata completata correttamente. In caso contrario, restituisce un codice di errore appropriato.

Commenti

I client audio richiedono una periodicità specifica dal motore audio con il parametro PeriodInFrames a IAudioClient3::InitializeSharedAudioStream. Il valore di PeriodInFrames deve essere un multiplo integrale del valore restituito nel parametro p FundamentalPeriodInFrames . PeriodInFrames deve anche essere maggiore o uguale al valore restituito in pMinPeriodInFrames e minore o uguale al valore di pMaxPeriodInFrames.

Ad esempio, per un formato a 44100 kHz, GetSharedModeEnginePeriod potrebbe restituire:

• pDefaultPeriodInFrames = 448 fotogrammi (circa 10,16 millisecondi)

• p FundamentalPeriodInFrames = 4 fotogrammi (circa 0,09 millisecondi)

• pMinPeriodInFrames = 48 fotogrammi (circa 1,09 millisecondi)

• pMaxPeriodInFrames = 448 fotogrammi (come impostazione predefinita)

I valori consentiti per il parametro PeriodInFrames per InitializeSharedAudioStream includono 48 e 448. Includerebbero anche cose come 96 e 128.

Non includerebbero 4 (minore del valore minimo consentito) o 98 (che non è un multiplo del fondamentale) o 1000 (maggiore del valore massimo consentito).

Requisiti

Vedi anche

IAudioClient3