WdfDeviceSetCharacteristics, fonction (wdfdevice.h)

  • Article

[S’applique à KMDF uniquement]

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

Syntaxe

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

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

[in] DeviceCharacteristics

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

Valeur de retour

None

Remarques

Un bogue case activée 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 rappel EvtDriverDeviceAdd avant d’appeler WdfDeviceCreate. Si votre pilote ne peut pas déterminer les caractéristiques d’un appareil tant que la fonction de rappel EvtDriverDeviceAdd n’est pas retournée, le pilote doit généralement appeler WdfDeviceSetCharacteristics dans sa fonction de rappel EvtDevicePrepareHardware .

Chaque appel à WdfDeviceSetCharacteristics remplace les paramètres de tout appel précédent.

Exemples

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

WdfDeviceSetCharacteristics(
                            Device,
                            FILE_REMOVABLE_MEDIA
                            );

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 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfDeviceGetCharacteristics

WdfDeviceInitSetCharacteristics