IoWMIDeviceObjectToInstanceName-Funktion (wdm.h)

  • Artikel

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
STATUS_SUCCESS
 Der Vorgang wurde erfolgreich ausgeführt. Die Routine speichert den instance Namen in der UNICODE_STRING, die durch den InstanceName-Parameter angegeben wird.
STATUS_WMI_INSTANCE_NOT_FOUND
 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

Weitere Informationen

DEVICE_OBJECT

IoWMIHandleToInstanceName

IoWMIOpenBlock