#include "ILMDVRSink.h"
C Syntax |
HRESULT ILMDVRSink_CreateEvents2(pILMDVRSink, nRegistrationID, TargetProcessID, pDataWrittenEvent, pRecordingListChangedEvent, pOffsetReachedEvent) |
C++ Syntax |
HRESULT CreateEvents(nRegistrationID, TargetProcessID, pDataWrittenEvent, pRecordingListChangedEvent, pOffsetReachedEvent) |
ILMDVRSink *pILMDVRSink ; |
/* pointer to an interface */ |
long nRegistrationID; |
/* events registration id */ |
long TargetProcessID; |
/* process id of subscriber */ |
OLE_HANDLE * pDataWrittenEvent; |
/* pointer to a data written event handle */ |
OLE_HANDLE * pRecordingListChangedEvent; |
/* pointer to a list changed event handle */ |
OLE_HANDLE * pOffsetReachedEvent; |
/* pointer to a offset reached event handle */ |
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. |
pOffsetReachedEvent |
Pointer to a handle for the offset reached 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.
Also, when data is written past the offset indicated by ILMDVRSink::SetOffsetToReach method, the offset reached event is 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. |
See Also
Example
For a C example, refer to ILMDVRSink::SetOffsetToReach Example for C
For a C++ example, refer to ILMDVRSink::SetOffsetToReach Example for C++