EVT_SERCX_FILEOPEN Rückruffunktion (sercx.h)
Die Ereignisrückruffunktion EvtSerCxFileOpen 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 Frameworkgerätobjekt, das den seriellen Controller darstellt.
Rückgabewert
Die EvtSerCxFileOpen-Funktion gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Andernfalls wird ein entsprechender Fehler status Code zurückgegeben.
Hinweise
Die Serial Framework-Erweiterung (SerCx) ruft diese Funktion auf, um die Hardware des seriellen Controllers für die Annahme von Anforderungen für E/A-Vorgänge vorzubereiten. Diese Funktion sollte den Controller in einem Zustand konfigurieren, in dem er bereit ist, Daten zu empfangen und zu übertragen. Wenn Interrupts erforderlich sind, sollte diese Funktion Interrupts aktivieren. Darüber hinaus sollte diese Funktion allen Arbeitsspeicher zuordnen, der nur während der Lebensdauer des Dateiobjekts benötigt wird. Diese Funktion kann beispielsweise einen Interruptdatenpuffer zuordnen.
Um eine EvtSerCxFileOpen-Rückruffunktion zu registrieren, muss der Treiber die SerCxInitialize-Methode aufrufen.
Weitere Informationen finden Sie unter Frameworkdateiobjekte.
Beispiele
Der Funktionstyp für diesen Rückruf wird in Sercx.h wie folgt deklariert.
typedef NTSTATUS
EVT_SERCX_FILEOPEN(
__in WDFDEVICE Device
);
Um eine EvtSerCxFileOpen-Rückruffunktion mit dem Namen MyEvtSerCxFileOpenzu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die der Static Driver Verifier (SDV) und andere Überprüfungstools erfordern.
EVT_SERCX_FILEOPEN MyEvtSerCxFileOpen;
Implementieren Sie dann Ihre 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8. |
| Zielplattform | Desktop |
| Kopfzeile | sercx.h |
| IRQL | Aufgerufen unter IRQL <= DISPATCH_LEVEL |