Función IoWMIDeviceObjectToInstanceName (wdm.h)

La rutina IoWMIDeviceObjectToInstanceName determina el nombre de instancia de la instancia de clase WMI implementada por el controlador especificado por un objeto de dispositivo.

Sintaxis

NTSTATUS IoWMIDeviceObjectToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  PDEVICE_OBJECT  DeviceObject,
  [out] PUNICODE_STRING InstanceName
);

Parámetros

[in] DataBlockObject

Puntero a un objeto de bloque de datos WMI. El autor de la llamada abre el objeto de bloque de datos para la clase WMI con IoWMIOpenBlock.

[in] DeviceObject

Especifica un objeto de dispositivo. La rutina devuelve el nombre de instancia del controlador correspondiente al objeto de dispositivo.

[out] InstanceName

Puntero a la estructura UNICODE_STRING que usa la rutina para devolver el nombre de la instancia. El autor de la llamada libera el búfer devuelto en UNICODE_STRING.

Valor devuelto

La rutina devuelve un código NTSTATUS. Entre los posibles valores devueltos se incluyen:

Código devuelto	Descripción
STATUS_SUCCESS	La operación se realizó correctamente. La rutina almacena el nombre de instancia en el UNICODE_STRING especificado por el parámetro InstanceName.
STATUS_WMI_INSTANCE_NOT_FOUND	El controlador no implementa ninguna instancia de la clase WMI especificada por DataBlockObject.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows XP y versiones posteriores del sistema operativo Windows.
de la plataforma de destino de	Universal
encabezado de	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= APC_LEVEL

Consulte también

DEVICE_OBJECT

ioWMIHandleToInstanceName

ioWMIOpenBlock