VideoPortCreateEvent, fonction (video.h)

Article
02/29/2024

La fonction VideoPortCreateEvent crée un objet d’événement.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in] EventFlag

Spécifie le type d’événement et l’état initial de l’événement. Il peut s’agir d’une combinaison ORed des indicateurs suivants :

Indicateur	Signification
INITIAL_EVENT_SIGNALED	Définissez cet indicateur pour indiquer l’état signalé pour l’objet d’événement. Sinon, l’état initial de l’événement n’est pas signé.
NOTIFICATION_EVENT	Définissez cet indicateur pour créer un événement de notification. Si cet indicateur n’est pas défini, un événement de synchronisation est créé.

[in] Unused

Est actuellement ignoré par le pilote de port vidéo et doit être défini sur NULL.

[out] ppEvent

Pointeur vers l’emplacement de mémoire auquel un pointeur vers l’objet d’événement sera retourné.

Valeur retournée

VideoPortCreateEvent retourne NO_ERROR si l’objet d’événement est correctement créé.

Remarques

Lorsqu’un événement de synchronisation est défini sur l’état signalé, un thread unique qui attendait l’état signalé est libéré (son état de distribution passe de l’état d’attente à prêt, de veille ou en cours d’exécution) et l’événement est automatiquement réinitialisé à l’état non signé.

Lorsqu’un événement de notification est défini sur l’état signalé, tous les threads qui attendaient l’état signalé sont libérés et l’événement reste dans l’état signalé jusqu’à ce qu’il soit explicitement réinitialisé à l’état non signé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows XP et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (incluez Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Voir aussi

VideoPortDeleteEvent

Partager via