In This Topic ▼

ILMDVRSink::CreateEvents2

#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.

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.

Help Version 20.0.2020.4.2

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help

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 DVR Buffer Locations on Multiple Physical Disks (C++), How to Copy Buffered DVR Data to a New File