VideoPortCreateEvent-Funktion (video.h)

  • Artikel

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

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] EventFlag

Gibt den Ereignistyp und den anfänglichen Ereignisstatus an. Dies kann eine ORed-Kombination der folgenden Flags sein:

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

[in] Unused

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

[out] ppEvent

Zeiger auf den Speicherort, an dem ein Zeiger auf das Ereignisobjekt zurückgegeben wird.

Rückgabewert

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

Hinweise

Wenn ein Synchronisierungsereignis auf den signalierten Zustand festgelegt ist, wird ein einzelner Thread, der auf den signalierten Zustand gewartet hat, freigegeben (dessen Dispatchzustand wechselt von Warten auf Bereit, Standby oder Ausführung), und das Ereignis wird automatisch in den nicht signalierten Zustand zurückgesetzt.

Wenn ein Benachrichtigungsereignis auf den signalierten Zustand festgelegt ist, werden alle Threads, die auf den signalierten Zustand gewartet haben, freigegeben, und das Ereignis verbleibt im signalierten Zustand, bis es explizit auf den nicht signalierten Zustand zurückgesetzt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows XP und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile video.h (Video.h einschließen)
Bibliothek Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

Weitere Informationen

VideoPortDeleteEvent