Compartir a través de

Función IoWMIDeviceObjectToInstanceName (wdm.h)

  • Artículo

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 la rutina usa para devolver el nombre de 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 valores devueltos posibles 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 Value
Cliente mínimo compatible Disponible en Windows XP y versiones posteriores del sistema operativo Windows.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

DEVICE_OBJECT

IoWMIHandleToInstanceName

IoWMIOpenBlock