Funzione SerCxCompleteWait (sercx.h)

  • Articolo

Il metodo SerCxCompleteWait notifica l'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 di 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 valori restituiti degli errori possibili includono il codice di stato seguente.

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

Commenti

Quando SerCx riceve una richiesta di IOCTL_SERIAL_SET_WAIT_MASK da un client, il gestore della richiesta in SerCx chiama la funzione di callback EvtSerCxWaitmask per notificare al driver del controller seriale che la maschera di attesa è stata modificata. La maschera di attesa specifica un set di eventi hardware per il controller seriale da monitorare. Durante questa chiamata, il driver ignora qualsiasi maschera di attesa precedente che potrebbe essere stata specificata in una precedente chiamata evtSerCxWaitmask 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 SerCx dell'evento. Se una richiesta di IOCTL_SERIAL_WAIT_ON_MASK inviata in precedenza è in sospeso, SerCxCompleteWait completa questa richiesta con lo stato di 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.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Piattaforma di destinazione Universale
Intestazione sercx.h
IRQL <= DISPATCH_LEVEL

Vedi anche

EvtSerCxWaitmask

IOCTL_SERIAL_SET_WAIT_MASK

IOCTL_SERIAL_WAIT_ON_MASK

SERIAL_EV_XXX

SerCxGetWaitMask