PosCxPutPendingEvent, fonction (poscx.h)

Article
02/07/2025

PosCxPutPendingEvent crée un objet d’événement, copie les données d’événement dans le nouvel objet d’événement et tente de le déléguer à l’appelant en attente. Si l’appelant cible n’a pas de demande de lecture en attente, le nouvel événement est ajouté à la file d’attente d’événements désignée (contrôle ou données).

Syntaxe

NTSTATUS PosCxPutPendingEvent(
  [in] WDFDEVICE               device,
  [in] ULONG                   deviceInterfaceTag,
  [in] ULONG                   eventType,
  [in] size_t                  rawEventDataSize,
       PVOID                   rawEventDataPtr,
  [in] POS_CX_EVENT_ATTRIBUTES eventAttr
);

Paramètres

[in] device

Handle vers un objet d’appareil framework qui représente l’appareil.

[in] deviceInterfaceTag

Interface d’appareil associée à l’événement. Par défaut, seuls les objets de fichier qui ont la même balise recevront cet événement.

[in] eventType

Nouveau type d’événement.

[in] rawEventDataSize

Taille de mémoire tampon d’événement brut (sans en-tête point de service) en octets.

rawEventDataPtr

Pointeur vers les données d’événement brutes (sans en-tête point de service). L’appelant peut réutiliser/libérer rawEventDataPtr après PosCxPutPendingEvent.

[in] eventAttr

Attributs d’événement.

Valeur de retour

Les valeurs de retour possibles sont les suivantes :

Valeur	Description
STATUS_SUCCESS	L’événement a été créé et délégué à un appelant en attente, ou l’événement a été ignoré, car il n’existe aucun propriétaire de l’appareil.
STATUS_PENDING	L’événement a été mis en file d’attente, car aucun appelant n’attend actuellement.
Autres erreurs	Autres codes d’erreur d’échec appropriés.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	poscx.h (include Poscx.h)

Voir aussi

POS_CX_EVENT_ATTRIBUTES

Partager via