Fonction WdfDeviceInitAssignName (wdfdevice.h)

[S’applique uniquement à KMDF]

La méthode WdfDeviceInitAssignName affecte un nom d’appareil à l’objet d’appareil d’un appareil.

Syntaxe

NTSTATUS WdfDeviceInitAssignName(
  [in]           PWDFDEVICE_INIT  DeviceInit,
  [in, optional] PCUNICODE_STRING DeviceName
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT .

[in, optional] DeviceName

Pointeur vers une structure UNICODE_STRING qui représente le nom de l’appareil.

Valeur retournée

Si WdfDeviceInitAssignName ne rencontre aucune erreur, il retourne STATUS_SUCCESS. Les valeurs de retour supplémentaires sont les suivantes :

Remarques

Si un pilote appelle WdfDeviceInitAssignName, il doit le faire avant d’appeler WdfDeviceCreate.

Si un pilote appelle WdfDeviceInitAssignName pour attribuer un nom, le pilote peut ensuite appeler WdfDeviceInitAssignName avec un paramètre NULLDeviceName pour effacer le nom de l’appareil. Si le nom de l’appareil est NULL et que l’objet d’appareil nécessite un nom (car il représente un PDO ou un appareil de contrôle), le système d’exploitation crée un nom.

Pour plus d’informations sur le nommage d’objets d’appareil, consultez Contrôle de l’accès aux appareils dans les pilotes Framework-Based.

Pour plus d’informations sur l’appel de WdfDeviceCreate, consultez Création d’un objet d’appareil framework.

Exemples

L’exemple de code suivant attribue un nom d’appareil NT à un appareil.

DECLARE_CONST_UNICODE_STRING(MyDeviceName, L"\\Device\\Ramdisk") ;
status = WdfDeviceInitAssignName(
                                 DeviceInit,
                                 &MyDeviceName
                                 );
if (!NT_SUCCESS(status)) {
    return status;
}

Configuration requise

Voir aussi

WdfDeviceRetrieveDeviceName