WdfDeviceInitSetCharacteristics, fonction (wdfdevice.h)

Article
02/27/2024

[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 membre Caractéristiques de la structure DEVICE_OBJECT .

[in] OrInValues

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

Valeur de retour

None

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 n’est pas retournée, appelez WdfDeviceSetCharacteristics.

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

L’infrastructure définit toujours la FILE_DEVICE_SECURE_OPEN caractéristique, 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 une disquette.

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfdevice.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
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