WdfDeviceAssignMofResourceName, fonction (wdfdevice.h)

Article
02/27/2024

[S’applique à KMDF uniquement]

La méthode WdfDeviceAssignMofResourceName inscrit un nom de ressource MOF pour un appareil spécifié.

Syntaxe

NTSTATUS WdfDeviceAssignMofResourceName(
  [in] WDFDEVICE        Device,
  [in] PCUNICODE_STRING MofResourceName
);

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

[in] MofResourceName

Pointeur vers une structure UNICODE_STRING qui spécifie le nom d’une ressource MOF.

Valeur retournée

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

Code de retour	Description
STATUS_INVALID_DEVICE_REQUEST	Le pilote a déjà appelé WdfDeviceAssignMofResourceName.
STATUS_INSUFFICIENT_RESOURCES	La mémoire disponible est insuffisante.

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

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Un pilote qui fournit un fichier MOF pour prendre en charge WMI doit appeler WdfDeviceAssignMofResourceName, généralement à partir de sa fonction de rappel EvtDriverDeviceAdd ou EvtDevicePrepareHardware . Le nom de la ressource MOF est le nom de fichier que le pilote spécifie dans une instruction MofResource dans son fichier de script de ressources (RC). Pour plus d’informations sur la spécification d’un nom de ressource MOF, consultez Compilation d’un fichier MOF de pilote.

Un pilote qui énumère les appareils sur un bus peut appeler WdfDeviceAssignMofResourceName pour l’appareil parent, et l’infrastructure utilise le nom de ressource MOF du parent pour les appareils enfants.

Pour plus d’informations sur WMI, consultez Prise en charge de WMI dans les pilotes Framework-Based.

Exemples

L’exemple de code suivant déclare une chaîne Unicode qui représente un nom de ressource MOF, puis inscrit le nom.

NTSTATUS  status;
DECLARE_CONST_UNICODE_STRING(mofRsrcName, MOFRESOURCENAME);

status = WdfDeviceAssignMofResourceName(
                                        Device,
                                        &mofRsrcName
                                        );
if (!NT_SUCCESS(status)) {
    return status;
}

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	PASSIVE_LEVEL
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Partager via