IAsyncReader2::GetEventHandle (Compact 7)
3/12/2014
This method returns a handle to the event that is signaled when new media samples are available.
Syntax
HRESULT GetEventHandle(
OAEVENT* pHandle
);
Parameters
- pHandle
[out] Event handle.
Return Value
Returns the HRESULT values shown in the following table.
| Value | Description |
|---|---|
E_FAIL E_INVALIDARG |
The event handle was not returned. |
S_OK |
The event handle was returned. |
Remarks
This event is a manual reset event. Do not call CloseHandle() on this event.
To monitor events, you declare a handle variable, cast it to an OAEVENT pointer, and then pass it to this method, as shown in the following code example.
HANDLE hEvent;
GetEventHandle( (OAEVENT*) &hEvent );
You can pass the returned event handle to the WaitForMultipleObjects function to wait for event notifications. Do not reset the handle in your application because the filter graph sets and resets events.
Requirements
Header |
dshow.h |
Library |
Strmiids.lib |