SpbDeviceInitConfig-Funktion (spbcx.h)
Die SpbDeviceInitConfig-Methode fügt die SPB-Frameworkerweiterung (SpbCx) an die E/A-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 |
|---|---|
|
Die erforderlichen Systemressourcen können nicht zugeordnet werden. |
Hinweise
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 veranschaulicht, wie die SpbDeviceInitConfig-Methode verwendet wird, 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8. |
| Zielplattform | Universell |
| Header | spbcx.h |
| Bibliothek | Spbcxstubs.lib |
| IRQL | PASSIVE_LEVEL |