IoWMIDeviceObjectToInstanceName-Funktion (wdm.h)

Artikel
02/07/2025

Die IoWMIDeviceObjectToInstanceName Routine bestimmt den Instanznamen für die vom Treiber implementierte WMI-Klasseninstanz, die 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 Instanznamen für den Treiber zurück, der dem Geräteobjekt entspricht.

[out] InstanceName

Zeigen Sie auf die UNICODE_STRING Struktur, die von der Routine zum Zurückgeben des Instanznamens verwendet wird. Der Aufrufer gibt den zurückgegebenen Puffer innerhalb UNICODE_STRINGfrei.

Rückgabewert

Die Routine gibt einen NTSTATUS-Code zurück. Mögliche Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Vorgang war erfolgreich. Die Routine speichert den Instanznamen in der durch den parameter InstanceName angegebenen UNICODE_STRING.
STATUS_WMI_INSTANCE_NOT_FOUND	Der Treiber implementiert keine Instanzen der WMI-Klasse, die durch DataBlockObject-angegeben wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows XP und höheren Versionen des Windows-Betriebssystems.
Zielplattform-	Universal
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL

Siehe auch

DEVICE_OBJECT

IoWMIHandleToInstanceName

IoWMIOpenBlock-

Freigeben über