Condividi tramite


EVT_SERCX_RECEIVE_CANCEL funzione di callback (sercx.h)

Il EvtSerCxReceiveCancel funzione di callback degli eventi 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 sospeso 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 un EvtSerCxReceiveCancel funzione di callback, il driver deve chiamare il metodo SerCxInitialize.

Esempi

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 un EvtSerCxReceiveCancel funzione di callback denominata MyEvtSerCxReceiveCancel, è prima necessario fornire una dichiarazione di funzione che static driver Verifier (SDV) e altri strumenti di verifica necessari, 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 i tipi di ruolo della funzione per i driver KMDF.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows 8.
piattaforma di destinazione Desktop
intestazione sercx.h
IRQL Chiamato in IRQL <= DISPATCH_LEVEL

Vedere anche

SerCxInitialize

SerCxProgressReceive