EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP Rückruffunktion (sercx.h)

Die EvtSerCx2CustomReceiveTransactionCleanup Ereignisrückruffunktion wird von Version 2 der seriellen Framework-Erweiterung (SerCx2) aufgerufen, um den Hardwarezustand des seriellen Controllers nach Beendigung einer benutzerdefinierten Empfangstransaktion zu bereinigen.

Syntax

EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP EvtSercx2CustomReceiveTransactionCleanup;

void EvtSercx2CustomReceiveTransactionCleanup(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
)
{...}

Parameter

[in] CustomReceiveTransaction

Ein SERCX2CUSTOMRECEIVETRANSACTION Handle für ein benutzerdefiniertes Empfangstransaktionsobjekt. Der serielle Controllertreiber hat zuvor den SerCx2CustomReceiveTransactionCreate Methode aufgerufen, um dieses Objekt zu erstellen.

Rückgabewert

Nichts

Bemerkungen

Ihr serieller Controllertreiber kann diese Funktion als Option implementieren. Falls implementiert, registriert der Treiber die Funktion im SerCx2CustomReceiveTransactionCreate Aufruf, der das objekt für den benutzerdefinierten Empfang erstellt.

Der serielle Controllertreiber sollte einen EvtSerCx2CustomReceiveTransactionCleanup--Funktion implementieren, wenn der serielle Controllerstatus am Ende einer benutzerdefinierten Empfangstransaktion bereinigt werden muss. SerCx2 ruft diese Funktion auf, wenn sie implementiert ist, nachdem eine benutzerdefinierte Empfangstransaktion beendet wurde. Als Reaktion auf den EvtSerCx2CustomReceiveTransactionCleanup Aufruf muss der serielle Controllertreiber den SerCx2CustomReceiveTransactionCleanupComplete Methode aufrufen, um SerCx2 zu benachrichtigen, nachdem die Bereinigung abgeschlossen wurde.

Weitere Informationen finden Sie unter SerCx2 Custom-Receive Transactions.

Beispiele

Um eine EvtSerCx2CustomReceiveTransactionCleanup Rückruffunktion zu definieren, müssen Sie zuerst eine Funktionsdeklaration bereitstellen, die den Typ der rückruffunktion identifiziert, die Sie definieren. Windows stellt eine Reihe von Rückruffunktionstypen für Treiber bereit. Durch das Deklarieren einer Funktion mithilfe der Rückruffunktionstypen können Codeanalyse für Treiber, statische Treiberüberprüfung (SDV) und andere Überprüfungstools Fehler finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine EvtSerCx2CustomReceiveTransactionCleanup Rückruffunktion zu definieren, die MyCustomReceiveTransactionCleanupbenannt ist, verwenden Sie den EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP Funktionstyp, wie in diesem Codebeispiel gezeigt:

EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP  MyCustomReceiveTransactionCleanup;

Implementieren Sie dann die Rückruffunktion wie folgt:

_Use_decl_annotations_
VOID
  MyCustomReceiveTransactionCleanup(
    SERCX2CUSTOMRECEIVETRANSACTION  CustomReceiveTransaction
    )
  {...}

Der EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP Funktionstyp wird in der Headerdatei Sercx.h definiert. Um Fehler genauer zu identifizieren, wenn Sie die Codeanalysetools ausführen, müssen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzufügen. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen, die auf den Funktionstyp EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP in der Headerdatei angewendet werden, verwendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für KMDF-Treiber. Weitere Informationen zu Use_decl_annotationsfinden Sie unter Annotating Function Behavior.

Anforderungen

Siehe auch

SERCX2CUSTOMRECEIVETRANSACTION

SerCx2CustomReceiveTransactionCleanupComplete

SerCx2CustomReceiveTransactionCreate