Fonction SpbDeviceInitConfig (spbcx.h)

Article
02/26/2024

La méthode SpbDeviceInitConfig attache l’extension d’infrastructure SPB (SpbCx) à la chaîne de demandes d’E/S pour un objet WDFDEVICE (FDO ou PDO) à créer.

Syntaxe

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

Paramètres

[in, out] DeviceInit

Pointeur vers la structure WDFDEVICE_INIT à configurer.

Valeur retournée

SpbDeviceInitConfig retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour possibles incluent le code d’erreur suivant.

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	Impossible d’allouer les ressources système requises.

Remarques

Cette méthode associe les informations de configuration de SpbCx à la structure WDFDEVICE_INIT de l’objet d’appareil (PDO ou FDO) à créer. La routine de rappel EvtDriverDeviceAdd de votre pilote doit appeler SpbDeviceInitConfig avant d’appeler la méthode WdfDeviceCreate pour créer l’objet d’appareil.

Exemples

L’exemple de code suivant montre comment utiliser la méthode SpbDeviceInitConfig pour associer les informations de configuration de l’extension de framework SpbCx à la structure 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,...);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Universal
En-tête	spbcx.h
Bibliothèque	Spbcxstubs.lib
IRQL	PASSIVE_LEVEL