#include "ILMDVRSink.h"
C Syntax |
HRESULT ILMDVRSink_CreateEvents(pILMDVRSink, nRegistrationID, TargetProcessID, pDataWrittenEvent, pRecordingListChangedEvent) |
C++ Syntax |
HRESULT CreateEvents(nRegistrationID, TargetProcessID, pDataWrittenEvent, pRecordingListChangedEvent) |
ILMDVRSink *pILMDVRSink ; |
/* pointer to an interface */ |
long nRegistrationID; |
/* events registration id */ |
long TargetProcessID; |
/* process id of subscriber. */ |
OLE_HANDLE * pDataWrittenEvent; |
/* pointer to handle a data write event */ |
OLE_HANDLE * pRecordingListChangedEvent; |
/* pointer to handle a list changed event */ |
Creates the windows event objects used by the DVRSink to signal data write and recording list changed events.
Parameter |
Description |
pILMDVRSink |
Pointer to an ILMDVRSink interface. |
nRegistrationID |
A unique identifier for this event registration. |
TargetProcessID |
The process id of the event subscriber. |
pDataWrittenEvent |
Pointer to a handle for the write event. |
pRecordingListChangedEvent |
Pointer to a handle for the list changed event. |
Returns
S_OK |
The function was successful. |
<> S_OK |
An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation. |
Comments
Whenever data is written to a buffer file, the windows event for the returned write event handle will be set. Likewise, when a buffer file is created or closed, the windows event for the list changed event handle will be set.
Returns S_OK if successful, otherwise a return code indicating the reason for failure:
E_OUTOFMEMORY = Memory allocation error was encountered.
Required DLLs and Libraries
LMDVRSink For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Win32, x64
See Also
Example
For a C example, refer to ILMDVRSink::CreateEvents Example for C
For a C++ example, refer to ILMDVRSink::CreateEvents Example for C++