SerCxInitialize-Funktion (sercx.h)
Die SerCxInitialize Methode schließt die Initialisierung der seriellen Framework-Erweiterung (SerCx) ab, nachdem dieser Treiber das zugeordnete Geräteobjekt erstellt hat.
Syntax
NTSTATUS SerCxInitialize(
[in] WDFDEVICE FxDevice,
[in] PSERCX_CONFIG Config
);
Parameter
[in] FxDevice
Ein WDFDEVICE-Handle für das Framework-Geräteobjekt, das den seriellen Controller darstellt.
[in] Config
Ein Zeiger auf eine vom Aufrufer zugewiesene SERCX_CONFIG Struktur, die Konfigurationsinformationen für SerCx enthält. Der Aufrufer hat zuvor die SERCX_CONFIG_INIT-Funktion aufgerufen, um diese Struktur zu initialisieren.
Rückgabewert
SerCxInitialize gibt bei erfolgreicher Ausführung STATUS_SUCCESS zurück. Mögliche Fehlerrückgabewerte sind die folgenden Statuscodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Methode wurde beim falschen IRQL aufgerufen; oder der WDFDEVICE-Handle ist ungültig; oder FxDevice oder Config ist NULL. |
|
Systemressourcen konnten nicht zugeordnet werden (in der Regel Arbeitsspeicher). |
Bemerkungen
Der serielle Controllertreiber ruft diese Methode auf, nachdem es das zugeordnete Geräteobjekt erstellt hat.
SerCxInitialize registriert die I/O-Rückruffunktionen des Controllertreibers bei SerCx. Darüber hinaus definiert diese Methode den Übertragungsmodus für die E/A-Warteschlange. Während des Aufrufs erstellt diese Methode alle internen Strukturen, die von SerCx benötigt werden (einschließlich der E/A-Warteschlange für den seriellen Controller). Nachdem diese Methode zurückgegeben wurde, ist SerCx bereit, E/A zu verarbeiten. Der Controllertreiber konfiguriert jedoch möglicherweise Controllerhardwareeinstellungen, bevor er aus dem EvtDriverDeviceAdd Rückruf zurückgibt, oder bevor er die PDO zur untergeordneten Liste hinzufügt.
Wenn die Parameter ungültig sind (wie in SERCX_CONFIGbeschrieben), löst Driver Verifier einen Fehler aus.
Diese Routine muss aufgerufen werden, bevor ein Commit für das Gerät durchgeführt wird (die Rückgabe von EvtDriverDeviceAdd oder Hinzufügen des PDO zur untergeordneten Liste).
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Zielplattform- | Universal |
| Header- | sercx.h |
| IRQL- | PASSIVE_LEVEL |