IoWMIDeviceObjectToInstanceName-Funktion (wdm.h)
Die IoWMIDeviceObjectToInstanceName-Routine bestimmt den instance Namen für die WMI-Klasse instance von dem Treiber implementiert, der von einem Geräteobjekt angegeben wird.
Syntax
NTSTATUS IoWMIDeviceObjectToInstanceName(
[in] PVOID DataBlockObject,
[in] PDEVICE_OBJECT DeviceObject,
[out] PUNICODE_STRING InstanceName
);
Parameter
[in] DataBlockObject
Zeiger auf ein WMI-Datenblockobjekt. Der Aufrufer öffnet das Datenblockobjekt für die WMI-Klasse mit IoWMIOpenBlock.
[in] DeviceObject
Gibt ein Geräteobjekt an. Die Routine gibt den instance Namen für den Treiber zurück, der dem Geräteobjekt entspricht.
[out] InstanceName
Zeiger auf die UNICODE_STRING-Struktur, die die Routine verwendet, um den namen der instance zurückzugeben. Der Aufrufer gibt den zurückgegebenen Puffer innerhalb UNICODE_STRING frei.
Rückgabewert
Die Routine gibt einen NTSTATUS-Code zurück. Mögliche Rückgabewerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. Die Routine speichert den instance Namen in der UNICODE_STRING, die durch den InstanceName-Parameter angegeben wird. |
|
Der Treiber implementiert keine Instanzen der von DataBlockObject angegebenen WMI-Klasse. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows XP und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |