EVT_SERCX_TRANSMIT_CANCEL Rückruffunktion (sercx.h)

Artikel
12/15/2024

Die EvtSerCxTransmitCancel Ereignisrückruffunktion benachrichtigt den seriellen Controllertreiber, dass die ausstehende Übertragungsanforderung abgebrochen wird.

Syntax

EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;

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

Parameter

[in] Device

Ein WDFDEVICE-Handle für das Framework-Geräteobjekt, das den seriellen Controller darstellt.

Rückgabewert

Nichts

Bemerkungen

Die serielle Framework-Erweiterung (SerCx) ruft diese Funktion auf, um den seriellen Controllertreiber darüber zu informieren, dass die aktuelle Übertragungsanforderung abgebrochen wurde. Wenn der Treiber über einen ausstehenden Übertragungsvorgang verfügt, sollte der Treiber diesen Vorgang abbrechen und den SerCxProgressTransmit Methode aufrufen, um den Abbruch zu melden. Legen Sie im SerCxProgressTransmit--Aufruf BytesTransmitted auf die Anzahl der vor dem Abbrechen des Vorgangs übertragenen Bytes fest, und legen Sie TransmitStatus- auf SerCxStatusCancelledfest.

Um eine EvtSerCxTransmitCancel Rückruffunktion zu registrieren, muss der Treiber die SerCxInitialize-Methode aufrufen.

Beispiele

Der Funktionstyp für diesen Rückruf wird wie folgt in Sercx.h deklariert.

typedef VOID
  EVT_SERCX_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

Um eine EvtSerCxTransmitCancel Rückruffunktion zu definieren, die MyEvtSerCxTransmitCancelheißt, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die Statische Treiberüberprüfung (SDV) und andere Überprüfungstools erforderlich ist.

EVT_SERCX_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;

Implementieren Sie dann die Rückruffunktion wie folgt.

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

Weitere Informationen zu SDV-Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für KMDF-Treiber.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 8.
Zielplattform-	Desktop
Header-	sercx.h
IRQL-	Bei IRQL-<= DISPATCH_LEVEL aufgerufen

Freigeben über