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 |
|---|---|
|
È 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) |