EVT_SERCX_FILEOPEN Rückruffunktion (sercx.h)
Die EvtSerCxFileOpen Ereignisrückruffunktion benachrichtigt den seriellen Controllertreiber, dass ein Client ein Dateihandle auf dem seriellen Controllergerät geöffnet hat und dass ein Dateiobjekt erstellt wurde, um das Gerät darzustellen.
Syntax
EVT_SERCX_FILEOPEN EvtSercxFileopen;
NTSTATUS EvtSercxFileopen(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Ein WDFDEVICE-Handle für das Framework-Geräteobjekt, das den seriellen Controller darstellt.
Rückgabewert
Die EvtSerCxFileOpen Funktion gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Andernfalls wird ein entsprechender Fehlerstatuscode zurückgegeben.
Bemerkungen
Die serielle Framework-Erweiterung (SerCx) ruft diese Funktion auf, um die serielle Controllerhardware vorzubereiten, um Anforderungen für E/A-Vorgänge zu akzeptieren. Diese Funktion sollte den Controller in einem Zustand konfigurieren, in dem er bereit ist, Daten zu empfangen und zu übertragen. Wenn Unterbrechungen erforderlich sind, sollte diese Funktion Unterbrechungen aktivieren. Darüber hinaus sollte diese Funktion alle Speicher zuweisen, die nur während der Lebensdauer des Dateiobjekts erforderlich sind. Diese Funktion kann z. B. einen Interruptdatenpuffer zuordnen.
Um eine EvtSerCxFileOpen Rückruffunktion zu registrieren, muss der Treiber die SerCxInitialize-Methode aufrufen.
Weitere Informationen finden Sie unter Framework File Objects.
Beispiele
Der Funktionstyp für diesen Rückruf wird wie folgt in Sercx.h deklariert.
typedef NTSTATUS
EVT_SERCX_FILEOPEN(
__in WDFDEVICE Device
);
Um eine EvtSerCxFileOpen Rückruffunktion zu definieren, die MyEvtSerCxFileOpenheißt, müssen Sie zunächst eine Funktionsdeklaration angeben, die statische Treiberüberprüfung (SDV) und andere Überprüfungstools erforderlich ist.
EVT_SERCX_FILEOPEN MyEvtSerCxFileOpen;
Implementieren Sie dann die Rückruffunktion wie folgt.
NTSTATUS
MyEvtSerCxFileOpen(
__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 |