Funzione WdfDeviceRetrieveDeviceName (wdfdevice.h)

[Si applica solo a KMDF]

Il metodo WdfDeviceRetrieveDeviceName restituisce il nome del dispositivo per un dispositivo specificato.

Sintassi

NTSTATUS WdfDeviceRetrieveDeviceName(
  [in] WDFDEVICE Device,
  [in] WDFSTRING String
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] String

Handle per un oggetto stringa del framework che riceve il nome del dispositivo.

Valore restituito

Se l'operazione ha esito positivo, WdfDeviceRetrieveDeviceName restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	È stato rilevato un parametro non valido.

 

Il metodo potrebbe restituire altri valori NTSTATUS.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Il metodo WdfDeviceRetrieveDeviceName restituisce il nome del dispositivo specificato in una chiamata precedente a WdfDeviceInitAssignName.

Per ottenere la stringa del nome del dispositivo dall'oggetto stringa, il driver può chiamare WdfStringGetUnicodeString.

Esempio

Nell'esempio di codice seguente viene creato un oggetto stringa e quindi viene recuperato il nome di un dispositivo specificato.

NTSTATUS status;
WDFSTRING string;

status = WdfStringCreate(
                         NULL,
                         WDF_NO_OBJECT_ATTRIBUTES,
                         &string
                         );
if (NT_SUCCESS(status)) {
    status = WdfDeviceRetrieveDeviceName(
                                         Device,
                                         string
                                         );
    if (!NT_SUCCESS(status)) {
        return status;
    }
}

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	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	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfDeviceInitAssignName

WdfDeviceQueryProperty

WdfStringCreate