WdfPdoInitAddCompatibleID, fonction (wdfpdo.h)

Article
02/29/2024

[S’applique à KMDF uniquement]

La méthode WdfPdoInitAddCompatibleID ajoute un ID compatible à la liste des ID compatibles pour un appareil enfant.

Syntaxe

NTSTATUS WdfPdoInitAddCompatibleID(
  [in] PWDFDEVICE_INIT  DeviceInit,
  [in] PCUNICODE_STRING CompatibleID
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT .

[in] CompatibleID

Pointeur vers une structure UNICODE_STRING qui contient une chaîne d’ID compatible. Le pilote peut allouer la mémoire tampon de la chaîne à partir d’un pool paginé.

Valeur retournée

Si l’opération réussit, la méthode retourne STATUS_SUCCESS. Les valeurs de retour supplémentaires sont les suivantes :

Code de retour	Description
STATUS_INVALID_DEVICE_REQUEST	Le pilote initialise un FDO au lieu d’un PDO.
STATUS_INSUFFICIENT_RESOURCES	Le pilote n’a pas pu allouer d’espace pour stocker la chaîne d’ID compatible.

La méthode peut également retourner d’autres valeurs NTSTATUS.

Remarques

Le pilote peut ajouter un ou plusieurs ID compatibles pour un appareil. Ils doivent être ajoutés dans l’ordre, de la meilleure correspondance à la pire correspondance. L’infrastructure remet les ID au gestionnaire PnP dans l’ordre dans lequel ils ont été ajoutés. Pour plus d’informations sur les ID compatibles, consultez Chaînes d’identification de périphérique et Comment le programme d’installation sélectionne les pilotes.

Le pilote doit appeler WdfPdoInitAddCompatibleID avant d’appeler WdfDeviceCreate. Pour plus d’informations sur l’appel de WdfDeviceCreate, consultez Création d’un objet d’appareil framework.

Exemples

L’exemple de code suivant indique une valeur d’ID compatible que l’exemple de pilote Toaster utilise.

DECLARE_CONST_UNICODE_STRING(compatId, L"{B85B7C50-6A01-11d2-B841-00C04FAD5171}\\MsCompatibleToaster\0");

status = WdfPdoInitAddCompatibleID(
                                   DeviceInit,
                                   &compatId
                                   );

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfpdo.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	ChildDeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf)

Voir aussi

WdfPdoInitAddHardwareID

WdfPdoInitAssignDeviceID

WdfPdoInitAssignInstanceID

Partager via