Funzione IoWMIDeviceObjectToInstanceName (wdm.h)
La routine IoWMIDeviceObjectToInstanceName determina il nome dell'istanza della classe WMI implementata dal driver specificato da un oggetto dispositivo.
Sintassi
NTSTATUS IoWMIDeviceObjectToInstanceName(
[in] PVOID DataBlockObject,
[in] PDEVICE_OBJECT DeviceObject,
[out] PUNICODE_STRING InstanceName
);
Parametri
[in] DataBlockObject
Puntatore a un oggetto blocco di dati WMI. Il chiamante apre l'oggetto blocco di dati per la classe WMI con IoWMIOpenBlock.
[in] DeviceObject
Specifica un oggetto dispositivo. La routine restituisce il nome dell'istanza per il driver corrispondente all'oggetto dispositivo.
[out] InstanceName
Puntatore alla struttura UNICODE_STRING utilizzata dalla routine per restituire il nome dell'istanza. Il chiamante libera il buffer restituito all'interno di UNICODE_STRING.
Valore restituito
La routine restituisce un codice NTSTATUS. I possibili valori restituiti includono:
| Codice restituito | Descrizione |
|---|---|
|
Operazione riuscita. La routine archivia il nome dell'istanza nel UNICODE_STRING specificato dal parametro InstanceName. |
|
Il driver non implementa istanze della classe WMI specificata da DataBlockObject. |
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows XP e versioni successive del sistema operativo Windows. |
| piattaforma di destinazione | Universale |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |