ILMDVRSink::CreateEvents2

Show in webframe

#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

Elements:	ILMDVRSink::FreeEvents, ILMDVRSink::StartChangingAttributes, ILMDVRSink::StopChangingAttributes,
Topics:	Multimedia Function Group, DVR Function Groups, Introduction to the LEADTOOLS MPEG-2 Transport Module, DVR Component FAQs, LEAD DVR Sink Filter, Accessing the DVR Sink Object,How to Use the DVR Sink Object to Control Capture Buffer Settings (C++), How to Set Capture Buffers on More Than One Physical Disk, How to Copy Buffered DVR Data to a New File

Example