Funzione PosCxPutPendingEvent (poscx.h)

Articolo
02/07/2025

PosCxPutPendingEvent crea un nuovo oggetto evento, copia i dati dell'evento nel nuovo oggetto evento e tenta di delegarlo al chiamante in attesa. Se il chiamante di destinazione non dispone di una richiesta di lettura in attesa, il nuovo evento viene aggiunto alla coda di eventi designata (controllo o dati).

Sintassi

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

Parametri

[in] device

Handle per un oggetto dispositivo framework che rappresenta il dispositivo.

[in] deviceInterfaceTag

Interfaccia del dispositivo associata all'evento. Per impostazione predefinita, solo gli oggetti file con lo stesso tag riceveranno questo evento.

[in] eventType

Nuovo tipo di evento.

[in] rawEventDataSize

Dimensione del buffer dell'evento non elaborato (senza intestazione punto di servizio) in byte.

rawEventDataPtr

Puntatore ai dati dell'evento non elaborati (senza intestazione punto di servizio). Il chiamante può riutilizzare o rilasciare rawEventDataPtr dopo PosCxPutPendingEvent.

[in] eventAttr

Attributi dell'evento.

Valore restituito

I possibili valori restituiti sono:

Valore	Descrizione
STATUS_SUCCESS	L'evento è stato creato e delegato a un chiamante in attesa oppure l'evento è stato rimosso perché non esiste alcun proprietario del dispositivo.
STATUS_PENDING	L'evento è stato accodato perché attualmente non è in attesa alcun chiamante.
Altri errori	Altri codici di errore appropriati.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	poscx.h (include Poscx.h)

Vedere anche

POS_CX_EVENT_ATTRIBUTES

Condividi tramite