WdfDeviceInitSetDeviceType, fonction (wdfdevice.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

La méthode WdfDeviceInitSetDeviceType définit le type d’appareil pour un appareil spécifié.

Syntaxe

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT.

[in] DeviceType

Valeur FILE_DEVICE_XXXX qui identifie le type d’appareil. Pour plus d’informations sur les valeurs FILE_DEVICE_XXXX, consultez Spécification des types d’appareils.

Valeur de retour

Aucun

Remarques

Si un pilote appelle WdfDeviceInitSetDeviceType, il doit le faire avant d’appeler WdfDeviceCreate.

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

Le type d’appareil spécifié par un pilote détermine la valeur d’augmentation de priorité par défaut utilisée par l’infrastructure lorsque le pilote termine une requête d’E/S. Pour plus d’informations sur les valeurs d’augmentation de priorité, consultez Spécification des boosts prioritaires lors de la fin des requêtes d’E/S.

Si vous écrivez un pilote UMDF, vous devez modifier le fichier INF de votre pilote ou apporter des modifications au Registre pour spécifier un type d’appareil. Pour plus d’informations sur l’utilisation du Registre, consultez Définition des propriétés du Registre d’objets d’appareil lors de l’installation.

Exemples

L’exemple de code suivant indique qu’un appareil est un appareil série.

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

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

Partager via