Funzione SerCxCompleteWait (sercx.h)

Articolo
12/13/2024

Il metodo SerCxCompleteWait notifica all'estensione del framework seriale (SerCx) che si è verificato un evento nella maschera di attesa corrente.

Sintassi

NTSTATUS SerCxCompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

Parametri

[in] Device

Handle WDFDEVICE per l'oggetto dispositivo framework che rappresenta il controller seriale.

[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

SerCxCompleteWait restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I possibili valori restituiti dall'errore includono il codice di stato seguente.

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	L'evento specificato non è incluso nella maschera di attesa corrente.

Osservazioni

Quando SerCx riceve una richiesta di IOCTL_SERIAL_SET_WAIT_MASK da un client, il gestore della richiesta in SerCx chiama il EvtSerCxWaitmask funzione di callback per notificare al driver del controller seriale che la maschera di attesa è cambiata. La maschera di attesa specifica un set di eventi hardware che il controller seriale deve monitorare. Durante questa chiamata, il driver elimina qualsiasi maschera di attesa precedente che potrebbe essere stata specificata in un precedente EvtSerCxWaitmask chiamata e quindi configura l'hardware del controller seriale per rilevare gli eventi nella nuova maschera di attesa.

Successivamente, quando si verifica un evento nella nuova maschera di attesa, il driver chiama SerCxCompleteWait per notificare a SerCx l'evento. Se una richiesta di IOCTL_SERIAL_WAIT_ON_MASK inviata in precedenza è in sospeso, SerCxCompleteWait completa questa richiesta con lo stato STATUS_SUCCESS e una maschera di attesa di output che indica quale evento si è verificato. In caso contrario, SerCxCompleteWait archivia l'evento nella cronologia degli eventi interni in previsione di una richiesta di IOCTL_SERIAL_WAIT_ON_MASK futura.