WdfDeviceInitSetDeviceClass, fonction (wdfdevice.h)

[S’applique uniquement à KMDF]

La méthode WdfDeviceInitSetDeviceClass spécifie un GUID qui identifie la classe de configuration d’appareil 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 des remplacements possibles pour les paramètres DefaultSDDLString, DeviceType, DeviceCharacteristicset paramètres exclusifs.

Valeur de retour

Aucun

Remarques

Le registre peut contenir des valeurs qui remplacent les valeurs spécifiées par un pilote lorsqu’il appelle WdfDeviceInitAssignSDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristicset 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 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
                            );

Exigences