EVT_SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CLEANUP Rückruffunktion (sercx.h)

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

Syntax

EVT_SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CLEANUP EvtSercx2CustomTransmitTransactionCleanup;

void EvtSercx2CustomTransmitTransactionCleanup(
  [in] SERCX2CUSTOMTRANSMITTRANSACTION CustomTransmitTransaction
)
{...}

Parameter

[in] CustomTransmitTransaction

Ein SERCX2CUSTOMTRANSMITTRANSACTION Handle für ein benutzerdefiniertes Übertragungsobjekt. Der serielle Controllertreiber hat zuvor den SerCx2CustomTransmitTransactionCreate Methode aufgerufen, um dieses Objekt zu erstellen.

Rückgabewert

Nichts

Bemerkungen

Ihr serieller Controllertreiber kann diese Funktion als Option implementieren. Wenn implementiert, registriert der Treiber die Funktion im SerCx2CustomTransmitTransactionCreate Aufruf, der das benutzerdefinierte Übertragungsobjekt erstellt.

Der serielle Controllertreiber sollte einen EvtSerCx2CustomTransmitTransactionCleanup--Funktion implementieren, wenn er den seriellen Controllerzustand am Ende einer benutzerdefinierten Übertragungstransaktion bereinigen muss. SerCx2 ruft diese Funktion auf, wenn sie implementiert ist, nachdem eine benutzerdefinierte Übertragungstransaktion beendet wurde. Als Reaktion auf den aufruf EvtSerCx2CustomTransmitTransactionCleanup muss der serielle Controllertreiber den SerCx2CustomTransmitTransactionCleanupComplete Methode aufrufen, um SerCx2 zu benachrichtigen, nachdem die Bereinigung abgeschlossen wurde.

Weitere Informationen finden Sie unter SerCx2 Custom-Transmit Transactions.

Beispiele

Um eine EvtSerCx2CustomTransmitTransactionCleanup 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 EvtSerCx2CustomTransmitTransactionCleanup Rückruffunktion zu definieren, die MyCustomTransmitTransactionCleanupbenannt ist, verwenden Sie den funktionstyp EVT_SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CLEANUP, wie in diesem Codebeispiel gezeigt:

EVT_SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CLEANUP  MyCustomTransmitTransactionCleanup;

Implementieren Sie dann die Rückruffunktion wie folgt:

_Use_decl_annotations_
VOID
  MyCustomTransmitTransactionCleanup(
    SERCX2CUSTOMTRANSMITTRANSACTION  CustomTransmitTransaction
    )
  {...}

Der EVT_SERCX2_CUSTOM_TRANSMIT_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_TRANSMIT_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

SERCX2CUSTOMTRANSMITTRANSACTION

SerCx2CustomTransmitTransactionCleanupComplete

SerCx2CustomTransmitTransactionCreate