Compartir a través de

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

  • Last updated on