EVT_SERCX_RECEIVE_CANCEL Rückruffunktion (sercx.h)
Die EvtSerCxReceiveCancel Ereignisrückruffunktion benachrichtigt den seriellen Controllertreiber, dass die ausstehende Empfangsanforderung abgebrochen wird.
Syntax
EVT_SERCX_RECEIVE_CANCEL EvtSercxReceiveCancel;
void EvtSercxReceiveCancel(
[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 Empfangsanforderung abgebrochen wurde. Wenn der Treiber über einen ausstehenden Empfangsvorgang verfügt, sollte der Treiber diesen Vorgang abbrechen und den SerCxProgressReceive Methode aufrufen, um den Abbruch zu melden. Legen Sie im SerCxProgressReceive Aufruf BytesReceived auf die Anzahl der empfangenen Bytes fest, bevor der Vorgang abgebrochen wurde, und legen Sie ReceiveStatus- auf SerCxStatusCancelledfest.
Um eine EvtSerCxReceiveCancel 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_RECEIVE_CANCEL(
__in WDFDEVICE Device
);
Um eine EvtSerCxReceiveCancel Rückruffunktion zu definieren, die MyEvtSerCxReceiveCancelbenannt ist, müssen Sie zunächst eine Funktionsdeklaration angeben, die statische Treiberüberprüfung (SDV) und andere Überprüfungstools erfordern, wie folgt.
EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;
Implementieren Sie dann die Rückruffunktion wie folgt.
VOID
MyEvtSerCxReceiveCancel(
__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 |