WdfDeviceSetCharacteristics, fonction (wdfdevice.h)

[S’applique uniquement à KMDF]

La méthode WdfDeviceSetCharacteristics définit les caractéristiques de l’appareil pour un appareil spécifié.

Syntaxe

VOID WdfDeviceSetCharacteristics(
  [in] WDFDEVICE Device,
  [in] ULONG     DeviceCharacteristics
);

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] DeviceCharacteristics

Valeur qui se compose de constantes définies par le système ORed qui représentent les caractéristiques de l’appareil. Pour plus d’informations, consultez le Caractéristiques membre de la structure DEVICE_OBJECT.

Valeur de retour

Aucun

Remarques

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Vous devez définir les caractéristiques de l’appareil en appelant la méthode WdfDeviceInitSetCharacteristics dans votre fonction de rappelEvtDriverDeviceAdd avant d’appeler WdfDeviceCreate. Si votre pilote ne peut pas déterminer les caractéristiques d’un appareil tant qu’après la EvtDriverDeviceAdd fonction de rappel retourne, le pilote doit généralement appeler WdfDeviceSetCharacteristics dans son EvtDevicePrepareHardware fonction de rappel.

Chaque appel à WdfDeviceSetCharacteristics remplace les paramètres d’un appel précédent.

Exemples

L’exemple de code suivant définit la caractéristique FILE_REMOVABLE_MEDIA d’un appareil spécifié.

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

Exigences

Voir aussi

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics