Funzione PosCxPutPendingEvent (poscx.h)

Articolo
02/29/2024

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-servizio) in byte.

rawEventDataPtr

Puntatore ai dati dell'evento non elaborati (senza intestazione point-of-service). Il chiamante può riutilizzare/rilasciare rawEventDataPtr dopo la restituzione di PosCxPutPendingEvent .

[in] eventAttr

Attributi dell'evento.

Valore restituito

I valori restituiti possibili 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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	poscx.h (include Poscx.h)

Vedi anche

POS_CX_EVENT_ATTRIBUTES

Condividi tramite