EVT_SERCX_RECEIVE_CANCEL funzione di callback (sercx.h)

  • Articolo

La funzione di callback dell'evento EvtSerCxReceiveCancel notifica al driver del controller seriale che la richiesta di ricezione in sospeso viene annullata.

Sintassi

EVT_SERCX_RECEIVE_CANCEL EvtSercxReceiveCancel;

void EvtSercxReceiveCancel(
  [in] WDFDEVICE Device
)
{...}

Parametri

[in] Device

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

Valore restituito

nessuno

Osservazioni

L'estensione del framework seriale (SerCx) chiama questa funzione per informare il driver del controller seriale che la richiesta di ricezione corrente è stata annullata. Se il driver ha un'operazione di ricezione in corso, il driver deve annullare questa operazione e chiamare il metodo SerCxProgressReceive per segnalare l'annullamento. Nella chiamata SerCxProgressReceive impostare BytesReceived sul numero di byte ricevuti prima dell'annullamento dell'operazione e impostare ReceiveStatus su SerCxStatusCancelled.

Per registrare una funzione di callback EvtSerCxReceiveCancel , il driver deve chiamare il metodo SerCxInitialize .

Esempio

Il tipo di funzione per questo callback viene dichiarato in Sercx.h, come indicato di seguito.

typedef VOID
  EVT_SERCX_RECEIVE_CANCEL(
    __in WDFDEVICE Device
    );

Per definire una funzione di callback EvtSerCxReceiveCancel denominata MyEvtSerCxReceiveCancel, è prima necessario specificare una dichiarazione di funzione che l'sdV ( Static Driver Verifier ) e altri strumenti di verifica richiedono, come indicato di seguito.

EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;

Implementare quindi la funzione di callback come indicato di seguito.

VOID
  MyEvtSerCxReceiveCancel(
    __in WDFDEVICE Device
    )
{ ... }

Per altre informazioni sui requisiti SDV per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite tipi di ruolo per i driver KMDF.

Requisiti

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

Vedi anche

SerCxInitialize

SerCxProgressReceive