IAudioClient3::GetSharedModeEnginePeriod 메서드(audioclient.h)

지정된 스트림 형식에 대해 엔진에서 지원하는 주기 범위 를 반환합니다. 엔진의 주기성은 엔진이 이벤트 기반 오디오 클라이언트를 절전 모드에서 해제하여 엔진과 오디오 데이터를 전송하는 속도입니다. 반환되는 값은 IAudioClient2::SetClientProperties에 대한 이전 호출을 통해 지정된 오디오 클라이언트의 특성에 따라 달라집니다.

구문

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

매개 변수

[in] pFormat

형식: const WAVEFORMATEX*

지원되는 주기를 쿼리하는 스트림 형식입니다.

[out] pDefaultPeriodInFrames

형식: UINT32*

엔진이 오디오 샘플을 전송하기 위해 클라이언트를 절전 모드에서 해제하는 기본 기간

[out] pFundamentalPeriodInFrames

형식: UINT32*

엔진이 오디오 샘플을 전송하기 위해 클라이언트를 절전 모드에서 해제하는 기본 기간입니다. 오디오 엔진 주기성을 설정할 때 이 값의 정수 배수를 사용해야 합니다.

[out] pMinPeriodInFrames

형식: UINT32*

오디오 엔진이 오디오 샘플을 전송하기 위해 클라이언트를 절전 모드에서 해제하는 가장 짧은 기간(오디오 프레임)입니다.

[out] pMaxPeriodInFrames

형식: UINT32*

오디오 엔진이 오디오 샘플을 전송하기 위해 클라이언트를 절전 모드에서 해제하는 가장 긴 기간(오디오 프레임)입니다.

반환 값

형식: HRESULT

이 메서드는 성공적으로 완료되었음을 나타내는 S_OK 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

오디오 클라이언트는 PeriodInFrames 매개 변수가 있는 오디오 엔진에서 IAudioClient3::InitializeSharedAudioStream으로 특정 주기를 요청합니다. PeriodInFrames 값은 pFundamentalPeriodInFrames 매개 변수에 반환된 값의 정수 배수여야 합니다. PeriodInFrames 는 pMinPeriodInFrames 에서 반환된 값보다 크거나 같아야 하며 pMaxPeriodInFrames 값보다 작거나 같아야 합니다.

예를 들어 44100kHz 형식의 경우 GetSharedModeEnginePeriod 는 다음을 반환할 수 있습니다.

• pDefaultPeriodInFrames = 448프레임(약 10.16밀리초)

• pFundamentalPeriodInFrames = 4프레임(약 0.09밀리초)

• pMinPeriodInFrames = 48프레임(약 1.09밀리초)

• pMaxPeriodInFrames = 448프레임(기본값과 동일)

InitializeSharedAudioStream에 대한 PeriodInFrames 매개 변수에 허용되는 값에는 48 및 448이 포함됩니다. 그들은 또한 같은 것 들을 포함 할 것 이다 96 그리고 128.

4(허용되는 최소 값보다 작음) 또는 98(기본 값의 배수가 아님) 또는 1000(허용되는 최대 값보다 큰 값)은 포함되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	audioclient.h

추가 정보

IAudioClient3