EVT_SERCX_TRANSMIT_CANCEL funzione di callback (sercx.h)

Articolo
08/07/2023

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

Sintassi

EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;

void EvtSercxTransmitCancel(
  [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 trasmissione corrente è stata annullata. Se il driver ha un'operazione di trasmissione in corso, il driver deve annullare questa operazione e chiamare il metodo SerCxProgressTransmit per segnalare l'annullamento. Nella chiamata SerCxProgressTransmit impostare BytesTransmitted sul numero di byte trasmessi prima dell'annullamento dell'operazione e impostare TransmitStatus su SerCxStatusCancelled.

Per registrare una funzione di callback EvtSerCxTransmitCancel , 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_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

Per definire una funzione di callback EvtSerCxTransmitCancel denominata MyEvtSerCxTransmitCancel, è prima necessario specificare una dichiarazione di funzione richiesta dall'utilità di verifica del driver statico (SDV) e altri strumenti di verifica, come indicato di seguito.

EVT_SERCX_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;

Implementare quindi la funzione di callback come indicato di seguito.

VOID
  MyEvtSerCxTransmitCancel(
    __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

Condividi tramite