IMFMediaEventGenerator::GetEvent 메서드(mfobjects.h)
큐에서 다음 이벤트를 검색합니다. 이 메서드는 동기적이며,
구문
HRESULT GetEvent(
[in] DWORD dwFlags,
[out] IMFMediaEvent **ppEvent
);
매개 변수
[in] dwFlags
다음 값 중 하나를 지정합니다.
값 | 의미 |
---|---|
|
메서드는 이벤트 생성기가 이벤트를 큐에 대기할 때까지 차단합니다. |
|
메서드는 즉시 반환됩니다. |
[out] ppEvent
IMFMediaEvent 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
반환 코드 | Description |
---|---|
|
메서드가 성공했습니다. |
|
NULL 포인터 인수입니다. |
|
보류 중인 요청이 있습니다. |
|
큐에 이벤트가 없습니다. |
|
개체가 종료되었습니다. |
설명
이 메서드는 동기적으로 실행됩니다.
큐에 이미 이벤트가 포함된 경우 메서드는 즉시 S_OK 반환합니다. 큐에 이벤트가 없는 경우 동작은 dwFlags 값에 따라 달라집니다.
- dwFlags가 0이면 메서드는 새 이벤트가 큐에 대기될 때까지 또는 이벤트 생성기가 종료될 때까지 무기한 차단됩니다.
- dwFlags가 MF_EVENT_FLAG_NO_WAIT 경우 반환 코드 MF_E_NO_EVENTS_AVAILABLE 메서드가 즉시 실패합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | mfobjects.h(Mfidl.h 포함) |
라이브러리 | Mfuuid.lib |