Funzione SpbDeviceInitConfig (spbcx.h)

Articolo
02/26/2024

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.

Commenti

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

Esempio

L'esempio di codice seguente illustra 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,...);

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.
Piattaforma di destinazione	Universale
Intestazione	spbcx.h
Libreria	Spbcxstubs.lib
IRQL	PASSIVE_LEVEL

Vedi anche

Condividi tramite