SerCxDeviceInitConfig-Funktion (sercx.h)

Artikel
12/16/2024

Die SerCxDeviceInitConfig--Methode wird vom seriellen Controllertreiber aufgerufen, um die serielle Frameworkerweiterung (SerCx) an die E/A-Pipeline für ein framework-Geräteobjekt (FDO oder PDO) anzufügen, das erstellt wird.

Syntax

NTSTATUS SerCxDeviceInitConfig(
  [in, out] PWDFDEVICE_INIT DeviceInit
);

Parameter

[in, out] DeviceInit

Ein Zeiger auf die WDFDEVICE_INIT Struktur, die konfiguriert werden soll.

Rückgabewert

SerCxDeviceInitConfig gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Mögliche Fehlerrücklaufwerte sind der folgende Statuscode.

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Systemressourcen konnten nicht zugeordnet werden (in der Regel Arbeitsspeicher).

Bemerkungen

Diese Methode ordnet die Konfigurationsinformationen von SerCx der WDFDEVICE_INIT Struktur für das zu erstellende Framework-Geräteobjekt (PDO oder FDO) zu. Rufen Sie SerCxDeviceInitConfig- auf, bevor Sie die WdfDeviceCreate-Methode aufrufen, um das Geräteobjekt zu erstellen.

Die EvtDriverDeviceAdd Rückruffunktion des Controllertreibers empfängt einen Zeiger auf eine initialisierte WDFDEVICE_INIT Struktur als Eingabeparameter.

SerCx legt einen Standardsicherheitsdeskriptor fest, den der serielle Controllertreiber bei Bedarf außer Kraft setzen kann. Mit diesem Standardsicherheitsdeskriptor kann beispielsweise ein Benutzermodustreiber eine E/A-Anforderung an ein Peripheriegerät senden, das mit einem Anschluss auf dem seriellen Controller verbunden ist. Um diese Einstellung im Sicherheitsdeskriptor zu ändern, kann der serielle Controllertreiber die WdfDeviceInitAssignSDDLString--Methode aufrufen. Dieser Aufruf muss nach dem aufruf SerCxDeviceInitConfig, aber vor dem Aufruf der WdfDeviceCreate-Methode erfolgen.

Beispiele

Im folgenden Codebeispiel übergibt ein Controllertreiber EvtDriverDeviceAdd Rückruffunktion eine initialisierte WDFDEVICE_INIT Struktur an die SerCxDeviceInitConfig--Methode. Der Aufruf von SerCxDeviceInitConfig- muss erfolgen, bevor der WdfDeviceCreate-Aufruf aufruf, der die FDO für das serielle Controllergerät (UART) erstellt.

//
// FxDeviceInit is a pointer to an initialized WDFDEVICE_INIT structure.
// Drivers receive a pointer to this structure as an input parameter to an
// EvtDriverDeviceAdd callback function, or as a return value from the
// WdfControlDeviceInitAllocate method.
//

status = SerCxDeviceInitConfig(FxDeviceInit);

if (!NT_SUCCESS(status))
{
    return status;
}

// 
// Set WDF and SerCx device-level configuration options.
//

...

//
// Call the WdfDeviceCreate method.
//

...