Funzione WdfDeviceInitAssignName (wdfdevice.h)

Articolo
07/16/2024

[Si applica solo a KMDF]

Il metodo WdfDeviceInitAssignName assegna un nome di dispositivo all'oggetto dispositivo di un dispositivo.

Sintassi

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

Parametri

[in] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT.

[in, optional] DeviceName

Puntatore a una struttura UNICODE_STRING che rappresenta il nome del dispositivo.

Valore restituito

Se WdfDeviceInitAssignName non rileva errori, restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	Il sistema non può allocare spazio per archiviare il nome del dispositivo.

Osservazioni

Se un driver chiama WdfDeviceInitAssignName, deve farlo prima di chiamare WdfDeviceCreate.

Se un driver chiama WdfDeviceInitAssignName per assegnare un nome, il driver può successivamente chiamare WdfDeviceInitAssignName con un NULLparametro DeviceName per cancellare il nome del dispositivo. Se il nome del dispositivo è NULL e l'oggetto dispositivo richiede un nome (perché rappresenta un PDO o un dispositivo di controllo ), il sistema operativo creerà un nome.

Per altre informazioni sulla denominazione degli oggetti dispositivo, vedere Controllo dell'accesso ai dispositivi in driver Framework-Based.

Per altre informazioni sulla chiamata di WdfDeviceCreate, vedere Creating a Framework Device Object.

Esempi

Nell'esempio di codice seguente viene assegnato un nome di dispositivo NT a un dispositivo.

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	PASSIVE_LEVEL
regole di conformità DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate() kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf) ), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf)

Vedere anche

WdfDeviceRetrieveDeviceName

Condividi tramite