VideoPortCreateEvent-Funktion (video.h)

Artikel
02/07/2025

Die VideoPortCreateEvent-Funktion erstellt ein Ereignisobjekt.

Syntax

VIDEOPORT_API VP_STATUS VideoPortCreateEvent(
  [in]  IN PVOID   HwDeviceExtension,
  [in]  IN ULONG   EventFlag,
  [in]  IN PVOID   Unused,
  [out] OUT PEVENT *ppEvent
);

Parameter

[in] HwDeviceExtension

Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.

[in] EventFlag

Gibt den Ereignistyp und den anfänglichen Ereignisstatus an. Dies kann eine kombination aus den folgenden Flags sein:

Flagge	Bedeutung
INITIAL_EVENT_SIGNALED	Legen Sie dieses Kennzeichen fest, um den signalierten Zustand für das Ereignisobjekt anzugeben. Andernfalls wird der Anfangszustand des Ereignisses nicht signalisiert.
NOTIFICATION_EVENT	Legen Sie dieses Kennzeichen fest, um ein Benachrichtigungsereignis zu erstellen. Wenn dieses Kennzeichen nicht festgelegt ist, wird ein Synchronisierungsereignis erstellt.

[in] Unused

Wird derzeit vom Videoporttreiber ignoriert und muss auf NULL-festgelegt werden.

[out] ppEvent

Zeiger auf die Speicherposition, an der ein Zeiger auf das Ereignisobjekt zurückgegeben wird.

Rückgabewert

VideoPortCreateEvent- gibt NO_ERROR zurück, wenn das Ereignisobjekt erfolgreich erstellt wurde.

Bemerkungen

Wenn ein Synchronisierungsereignis auf den signalisierten Zustand festgelegt ist, wird ein einzelner Thread, der auf den signalisierten Zustand wartet, losgelassen (seine Verteilerstatusübergänge vom Warten auf bereit, Standbymodus oder Ausführung), und das Ereignis wird automatisch auf den nicht signalfähigen Zustand zurückgesetzt.

Wenn ein Benachrichtigungsereignis auf den signalisierten Zustand festgelegt ist, werden alle Threads, die auf den signalisierten Zustand warten, losgelassen, und das Ereignis verbleibt im signalierten Zustand, bis es explizit auf den nichtsignalierten Zustand zurückgesetzt wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows XP und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
Library	Videoprt.lib
DLL-	Videoprt.sys
IRQL-	PASSIVE_LEVEL

Siehe auch

VideoPortDeleteEvent-

Freigeben über