Funzione SpbDeviceInitConfig (spbcx.h)

2025-02-07

Il metodo SpbDeviceInitConfig collega l'estensione del framework SPB (SpbCx) alla catena di richieste I/O per un oggetto WDFDEVICE (FDO o PDO) da creare.

Sintassi

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

Parametri

[in, out] DeviceInit

Puntatore alla struttura WDFDEVICE_INIT da configurare.

Valore restituito

SpbDeviceInitConfig restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti possibili includono il codice di errore seguente.

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	Impossibile allocare le risorse di sistema necessarie.

Osservazioni

Questo metodo associa le informazioni di configurazione per SpbCx alla struttura WDFDEVICE_INIT per l'oggetto dispositivo (PDO o FDO) che deve essere creato. Il driver EvtDriverDeviceAdd routine di callback deve chiamare SpbDeviceInitConfig prima di chiamare il metodo WdfDeviceCreate per creare l'oggetto dispositivo.

Esempi

Nell'esempio di codice seguente viene illustrato come usare il metodo SpbDeviceInitConfig per associare le informazioni di configurazione dell'estensione del framework SpbCx alla struttura WDFDEVICE_INIT.

//
// 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,...);

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Universale
intestazione	spbcx.h
libreria	Spbcxstubs.lib
IRQL	PASSIVE_LEVEL

Vedere anche