WdfPdoInitAssignInstanceID, fonction (wdfpdo.h)
[S’applique à KMDF uniquement]
La méthode WdfPdoInitAssignInstanceID met à jour l’ID de instance d’un appareil enfant.
Syntaxe
NTSTATUS WdfPdoInitAssignInstanceID(
[in] PWDFDEVICE_INIT DeviceInit,
[in] PCUNICODE_STRING InstanceID
);
Paramètres
[in] DeviceInit
Pointeur vers une structure WDFDEVICE_INIT .
[in] InstanceID
Pointeur vers une structure UNICODE_STRING qui contient une chaîne d’ID instance. 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 |
---|---|
|
Le pilote initialise un FDO au lieu d’un PDO. |
|
Le pilote n’a pas pu allouer d’espace pour stocker la chaîne d’ID instance. |
La méthode peut également retourner d’autres valeurs NTSTATUS.
Remarques
Pour plus d’informations sur les ID instance, consultez Chaînes d’identification d’appareil.
Le pilote doit appeler WdfPdoInitAssignInstanceID 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 convertit le numéro de série d’un appareil en chaîne Unicode, puis inscrit la chaîne Unicode en tant qu’ID de instance de l’appareil.
DECLARE_UNICODE_STRING_SIZE(instanceID, INSTANCEID_LENGTH);
status = RtlIntegerToUnicodeString(
SerialNo,
BASE_DEC,
&instanceID
);
status = WdfPdoInitAssignInstanceID(
pDeviceInit,
&instanceID
);
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour