WdfDeviceAssignMofResourceName, fonction (wdfdevice.h)

Article
02/07/2025

[S’applique uniquement à KMDF]

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 vers un objet d’appareil framework.

[in] MofResourceName

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

Valeur de retour

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

Retourner le code	Description
STATUS_INVALID_DEVICE_REQUEST	Le pilote a déjà appelé WdfDeviceAssignMofResourceName.
STATUS_INSUFFICIENT_RESOURCES	La mémoire insuffisante est disponible.

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

Une vérification de bogue 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 son EvtDriverDeviceAdd ou EvtDevicePrepareHardware fonction de rappel. Le nom de la ressource MOF est le nom de fichier spécifié par le pilote dans une instruction MofResource dans son fichier RC (Resource Script). Pour plus d’informations sur la spécification d’un nom de ressource MOF, consultez Compilation du fichier MOF d’un 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 Framework-Based Pilotes.

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;
}

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
d’en-tête	wdfdevice.h (include Wdf.h)
bibliothèque	Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL	PASSIVE_LEVEL
règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Partager via