Expand Minimize

VideoPortCreateEvent function

The VideoPortCreateEvent function creates an event object.

Syntax


VP_STATUS VideoPortCreateEvent(
  _In_   PVOID  HwDeviceExtension,
  _In_   ULONG  EventFlag,
  _In_   PVOID  Unused,
  _Out_  PEVENT *ppEvent
);

Parameters

HwDeviceExtension [in]

Pointer to the miniport driver's device extension.

EventFlag [in]

Specifies the event type and initial event state. This can be an ORed combination of the following flags:

FlagMeaning

INITIAL_EVENT_SIGNALED

Set this flag to indicate the signaled state for the event object. Otherwise, the initial state of the event is nonsignaled.

NOTIFICATION_EVENT

Set this flag to create a notification event. If this flag is not set, a synchronization event is created.

 

Unused [in]

Is currently ignored by the video port driver and must be set to NULL.

ppEvent [out]

Pointer to the memory location at which a pointer to the event object will be returned.

Return value

VideoPortCreateEvent returns NO_ERROR if the event object is successfully created.

Remarks

When a synchronization event is set to the signaled state, a single thread that was waiting for the signaled state is released (its dispatch state transitions from waiting to ready, standby, or running), and the event is automatically reset to the nonsignaled state.

When a notification event is set to the signaled state, all threads that were waiting for the signaled state are released, and the event remains in the signaled state until it is explicitly reset to the nonsignaled state.

Requirements

Target platform

Desktop

Version

Available in Windows XP and later versions of the Windows operating systems.

Header

Video.h (include Video.h)

Library

Videoprt.lib

DLL

Videoprt.sys

IRQL

PASSIVE_LEVEL

See also

VideoPortDeleteEvent

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft