EVT_SERCX_TRANSMIT_CANCEL funzione di callback (sercx.h)

Articolo
12/13/2024

Il EvtSerCxTransmitCancel funzione di callback dell'evento 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 sospeso 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 un EvtSerCxTransmitCancel 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_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

Per definire un EvtSerCxTransmitCancel funzione di callback denominata MyEvtSerCxTransmitCancel, è prima necessario fornire una dichiarazione di funzione che static driver Verifier (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 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

Condividi tramite