EVT_SERCX_RECEIVE_CANCEL Rückruffunktion (sercx.h)
Die Ereignisrückruffunktion EvtSerCxReceiveCancel 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 Frameworkgerätobjekt, das den seriellen Controller darstellt.
Rückgabewert
Keine
Bemerkungen
Die Serial Framework-Erweiterung (SerCx) ruft diese Funktion auf, um den seriellen Controllertreiber darüber zu informieren, dass die aktuelle Empfangsanforderung abgebrochen wurde. Wenn für den Treiber ein ausstehender Empfangsvorgang ausgeführt wird, sollte der Treiber diesen Vorgang abbrechen und die SerCxProgressReceive-Methode aufrufen, um den Abbruch zu melden. Legen Sie im SerCxProgressReceive-AufrufBytesReceived auf die Anzahl der Bytes fest, die empfangen wurden, bevor der Vorgang abgebrochen wurde, und legen Sie ReceiveStatus auf SerCxStatusCancelled fest.
Um eine EvtSerCxReceiveCancel-Rückruffunktion zu registrieren, muss der Treiber die SerCxInitialize-Methode aufrufen.
Beispiele
Der Funktionstyp für diesen Rückruf wird in Sercx.h wie folgt deklariert.
typedef VOID
EVT_SERCX_RECEIVE_CANCEL(
__in WDFDEVICE Device
);
Um eine EvtSerCxReceiveCancel-Rückruffunktion mit dem Namen MyEvtSerCxReceiveCancelzu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die der Static Driver Verifier (SDV) und andere Überprüfungstools erfordern.
EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;
Implementieren Sie dann Ihre 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8. |
| Zielplattform | Desktop |
| Kopfzeile | sercx.h |
| IRQL | Aufgerufen unter IRQL <= DISPATCH_LEVEL |