Condividi tramite


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