Freigeben über


SpbDeviceInitConfig-Funktion (spbcx.h)

Die SpbDeviceInitConfig--Methode fügt die SPB-Frameworkerweiterung (SpbCx) an die I/O-Anforderungskette für ein zu erstellendes WDFDEVICE -Objekt (FDO oder PDO) an.

Syntax

NTSTATUS SpbDeviceInitConfig(
  [in, out] WDFDEVICE_INIT *DeviceInit
);

Parameter

[in, out] DeviceInit

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

Rückgabewert

SpbDeviceInitConfig gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Mögliche Rückgabewerte sind der folgende Fehlercode.

Rückgabecode Beschreibung
STATUS_INSUFFICIENT_RESOURCES
Die erforderlichen Systemressourcen können nicht zugeordnet werden.

Bemerkungen

Diese Methode ordnet die Konfigurationsinformationen für SpbCx der WDFDEVICE_INIT Struktur für das zu erstellende Geräteobjekt (PDO oder FDO) zu. Die EvtDriverDeviceAdd Rückrufroutine Ihres Treibers sollte SpbDeviceInitConfig aufrufen, bevor die WdfDeviceCreate Methode aufgerufen wird, um das Geräteobjekt zu erstellen.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die SpbDeviceInitConfig--Methode verwenden, um die Konfigurationsinformationen der SpbCx-Frameworkerweiterung der WDFDEVICE_INIT Struktur zuzuordnen.

//
// FxDeviceInit is a pointer to a WDFDEVICE_INIT structure that comes as a
// parameter for an EvtDriverDeviceAdd handler, or from WdfPdoInitAllocate.
//

status = SpbDeviceInitConfig(FxDeviceInit);

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

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

...

//
// Call WdfDeviceCreate
//

status = WdfDeviceCreate(&FxDeviceInit,...);


Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar ab Windows 8.
Zielplattform- Universal
Header- spbcx.h
Library Spbcxstubs.lib
IRQL- PASSIVE_LEVEL

Siehe auch

EvtDriverDeviceAdd

WDFDEVICE_INIT

WdfDeviceCreate

WdfPdoInitAllocate