WdfDeviceSetCharacteristics, fonction (wdfdevice.h)
[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) |