IMFMediaEventGenerator::GetEvent 메서드(mfobjects.h)

큐에서 다음 이벤트를 검색합니다. 이 메서드는 동기적이며,

구문

HRESULT GetEvent(
  [in]  DWORD         dwFlags,
  [out] IMFMediaEvent **ppEvent
);

매개 변수

[in] dwFlags

다음 값 중 하나를 지정합니다.

의미
0
메서드는 이벤트 생성기가 이벤트를 큐에 대기할 때까지 차단합니다.
MF_EVENT_FLAG_NO_WAIT
메서드는 즉시 반환됩니다.

[out] ppEvent

IMFMediaEvent 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드 Description
S_OK
메서드가 성공했습니다.
E_INVALIDARG
NULL 포인터 인수입니다.
MF_E_MULTIPLE_SUBSCRIBERS
보류 중인 요청이 있습니다.
MF_E_NO_EVENTS_AVAILABLE
큐에 이벤트가 없습니다.
MF_E_SHUTDOWN
개체가 종료되었습니다.

설명

이 메서드는 동기적으로 실행됩니다.

큐에 이미 이벤트가 포함된 경우 메서드는 즉시 S_OK 반환합니다. 큐에 이벤트가 없는 경우 동작은 dwFlags 값에 따라 달라집니다.

  • dwFlags가 0이면 메서드는 새 이벤트가 큐에 대기될 때까지 또는 이벤트 생성기가 종료될 때까지 무기한 차단됩니다.
  • dwFlags가 MF_EVENT_FLAG_NO_WAIT 경우 반환 코드 MF_E_NO_EVENTS_AVAILABLE 메서드가 즉시 실패합니다.
이 메서드는 이전에 IMFMediaEventGenerator::BeginGetEvent 를 호출했으며 아직 IMFMediaEventGenerator::EndGetEvent를 호출하지 않은 경우 MF_E_MULTIPLE_SUBSCRIBERS 반환합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfobjects.h(Mfidl.h 포함)
라이브러리 Mfuuid.lib

추가 정보

IMFMediaEventGenerator

미디어 이벤트 생성기