EVT_SERCX2_PIO_RECEIVE_INITIALIZE_TRANSACTION Rückruffunktion (sercx.h)

Die EvtSerCx2PioReceiveInitializeTransaction Ereignisrückruffunktion wird von Version 2 der seriellen Framework-Erweiterung (SerCx2) aufgerufen, um den seriellen Controller für die Durchführung einer PIO-Empfangstransaktion vorzubereiten.

Syntax

EVT_SERCX2_PIO_RECEIVE_INITIALIZE_TRANSACTION EvtSercx2PioReceiveInitializeTransaction;

void EvtSercx2PioReceiveInitializeTransaction(
  [in] SERCX2PIORECEIVE PioReceive,
  [in] ULONG Length
)
{...}

Parameter

[in] PioReceive

Ein SERCX2PIORECEIVE Handle für ein PIO-Empfangsobjekt. Der serielle Controllertreiber hat zuvor den SerCx2PioReceiveCreate Methode aufgerufen, um dieses Objekt zu erstellen.

[in] Length

Die Anzahl der Bytes, die in der PIO-Empfangstransaktion übertragen werden sollen.

Rückgabewert

Nichts

Bemerkungen

Ihr serieller Controllertreiber kann diese Funktion als Option implementieren. Wenn implementiert, registriert der Treiber die Funktion im Aufruf des SerCx2PioReceiveCreate-Methode, die das PIO-Empfangsobjekt erstellt.

Ihr Treiber sollte eine EvtSerCx2PioReceiveInitializeTransaction--Funktion implementieren, wenn der serielle Controller und die zugehörige Hardware in Vorbereitung auf eine neue PIO-Empfangstransaktion initialisiert werden müssen. SerCx2 ruft diese Funktion auf, wenn sie implementiert ist, bevor eine PIO-Empfangstransaktion gestartet wird. Als Reaktion auf diesen Aufruf muss der serielle Controllertreiber die SerCx2PioReceiveInitializeTransactionComplete--Methode aufrufen, um SerCx2 nach Abschluss der Initialisierung zu benachrichtigen.

Weitere Informationen finden Sie unter SerCx2 PIO-Receive Transactions.

Beispiele

Um eine EvtSerCx2PioReceiveInitializeTransaction 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.

Wenn Sie beispielsweise eine EvtSerCx2PioReceiveInitializeTransaction Rückruffunktion definieren möchten, die MyPioReceiveInitializeTransactionheißt, verwenden Sie den funktionstyp EVT_SERCX2_PIO_RECEIVE_INITIALIZE_TRANSACTION, wie in diesem Codebeispiel gezeigt:

EVT_SERCX2_PIO_RECEIVE_INITIALIZE_TRANSACTION  MyPioReceiveInitializeTransaction;

Implementieren Sie dann die Rückruffunktion wie folgt:

_Use_decl_annotations_
VOID
  MyPioReceiveInitializeTransaction(
    SERCX2PIORECEIVE  PioReceive,
    ULONG  Length
    )
  {...}

Der EVT_SERCX2_PIO_RECEIVE_INITIALIZE_TRANSACTION 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_PIO_RECEIVE_INITIALIZE_TRANSACTION 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

SERCX2PIORECEIVE

SerCx2PioReceiveCreate

SerCx2PioReceiveInitializeTransactionComplete