WdfDeviceInitSetDeviceClass, fonction (wdfdevice.h)

Article
08/08/2023

[S’applique à KMDF uniquement]

La méthode WdfDeviceInitSetDeviceClass spécifie un GUID qui identifie la classe de configuration de l’appareil.

Syntaxe

void WdfDeviceInitSetDeviceClass(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] const GUID      *DeviceClassGuid
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT .

[in] DeviceClassGuid

Pointeur vers un GUID qui identifie une section du Registre contenant les remplacements possibles pour les paramètres DefaultSDDLString, DeviceType, DeviceCharacteristics et Exclusive .

Note Vous devez toujours spécifier un GUID de classe personnalisé. Vous ne devez pas spécifier un GUID de classe existant. Si vous spécifiez un GUID de classe existant, d’autres pilotes qui tentent de spécifier ce GUID de classe existant peuvent ne pas être installés ou installer avec des paramètres de sécurité incorrects.

Valeur de retour

None

Remarques

Le Registre peut contenir des valeurs qui remplacent les valeurs spécifiées par un pilote lorsqu’il appelle WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics et WdfDeviceInitSetExclusive. Le pilote peut appeler WdfDeviceInitSetDeviceClass pour spécifier un GUID qui identifie la section du Registre qui contient les valeurs de remplacement.

En règle générale, un pilote appelle WdfDeviceInitSetDeviceClass uniquement s’il crée un périphérique de contrôle.

Pour plus d’informations sur l’utilisation du Registre, consultez Définition des propriétés du registre d’objets d’appareil après l’installation.

Si un pilote appelle WdfDeviceInitSetDeviceClass, il doit le faire avant d’appeler WdfDeviceCreate.

Pour plus d’informations sur l’appel de WdfDeviceCreate, consultez Création d’un objet d’appareil framework.

Exemples

L’exemple de code suivant définit la classe d’installation d’un appareil sur la classe d’appareil système.

DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);

WdfDeviceInitSetDeviceClass(
                            DeviceInit,
                            &GUID_DEVCLASS_MYUNIQUEID
                            );

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfdevice.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)