Funzione SerCx2CompleteWait (sercx.h)

Articolo
10/30/2024

Il metodo SerCx2CompleteWait notifica alla versione 2 dell'estensione del framework seriale (SerCx2) che si è verificato un evento nella maschera di attesa corrente.

Sintassi

void SerCx2CompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

Parametri

[in] Device

Handle WDFDEVICE per l'oggetto dispositivo framework che rappresenta il controller seriale. Il driver del controller seriale ha creato questo oggetto nel relativo EvtDriverDeviceAdd funzione di callback. Per altre informazioni, vedere SerCx2InitializeDevice.

[in] Event

Tipo di evento che termina l'operazione di attesa corrente. Questo parametro è un valore della maschera di attesa. Ogni tipo di evento corrisponde a un bit specifico nella maschera di attesa. Questo bit è impostato per indicare che si è verificato l'evento corrispondente. Per altre informazioni sui tipi di eventi che possono essere specificati da una maschera di attesa, vedere SERIAL_EV_XXX.

Valore restituito

Nessuno

Osservazioni

Quando SerCx2 riceve una richiesta di IOCTL_SERIAL_SET_WAIT_MASK da un client, il gestore della richiesta in SerCx2 chiama il EvtSerCx2SetWaitMask funzione di callback per notificare al driver del controller seriale che la maschera di attesa è stata modificata.

Quando si verifica un evento nella nuova maschera di attesa, il driver chiama SerCx2CompleteWait per notificare a SerCx2 l'evento. Se una richiesta IOCTL_SERIAL_WAIT_ON_MASK inviata in precedenza è in sospeso in SerCx2 al momento della SerCx2CompleteWait chiamata, SerCx2 completa questa richiesta con una maschera di attesa di output che indica quale evento si è verificato. In caso contrario, SerCx2 archivia l'evento nella cronologia degli eventi interni in previsione di una richiesta di IOCTL_SERIAL_WAIT_ON_MASK futura.