WdfDeviceInitSetDeviceType, fonction (wdfdevice.h)

Article
02/29/2024

[S’applique à KMDF uniquement]

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

None

Remarques

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

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

Le type de périphérique spécifié par un pilote détermine la valeur d’augmentation de priorité par défaut que l’infrastructure utilise quand le pilote termine une demande d’E/S. Pour plus d’informations sur les valeurs d’augmentation de priorité, consultez Spécification des augmentations de priorité lors de la fin des demandes 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 de périphérique. Pour plus d’informations sur l’utilisation du Registre, consultez Définition des propriétés du registre d’objets d’appareil pendant l’installation.

Exemples

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

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

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

Partager via