WdfDeviceInitSetCharacteristics, fonction (wdfdevice.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

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

Syntaxe

void WdfDeviceInitSetCharacteristics(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] ULONG           DeviceCharacteristics,
  [in] BOOLEAN         OrInValues
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT.

[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.

[in] OrInValues

Valeur booléenne. Si cette valeur est TRUE, la valeur DeviceCharacteristics est ORed avec les caractéristiques existantes de l’appareil. Si la valeur est FALSE, la valeur DeviceCharacteristics remplace les caractéristiques existantes de l’appareil.

Valeur de retour

Aucun

Remarques

Pour définir les caractéristiques de l’appareil, appelez 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 retourne, appelez WdfDeviceSetCharacteristics.

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

L’infrastructure définit toujours la caractéristique FILE_DEVICE_SECURE_OPEN, de sorte que votre pilote n’a pas à définir cette caractéristique.

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

Exemples

L’exemple de code suivant indique qu’un appareil est un disque de floppy.

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
d’en-tête	wdfdevice.h (include Wdf.h)
bibliothèque	Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL	<= DISPATCH_LEVEL
règles de conformité DDI	childDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Voir aussi

WdfDeviceSetCharacteristics

Partager via