WdfPdoInitAddCompatibleID, fonction (wdfpdo.h)

[S’applique uniquement à KMDF]

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 du pool paginé.

Valeur de retour

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

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, du meilleur match au pire match. Le framework fournira 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 d’appareil 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 WdfDeviceCreate, consultez Création d’un objet d’appareil Framework.

Exemples

L’exemple de code suivant signale une valeur d’ID compatible utilisée par l’exemple de pilote Grille-pain.

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

status = WdfPdoInitAddCompatibleID(
                                   DeviceInit,
                                   &compatId
                                   );

Spécifications

Voir aussi

WdfPdoInitAddHardwareID

WdfPdoInitAssignDeviceID

WdfPdoInitAssignInstanceID