Função IoWMIDeviceObjectToInstanceName (wdm.h)

Artigo
02/27/2024

A rotina IoWMIDeviceObjectToInstanceName determina o nome da instância da instância da classe WMI implementada pelo driver especificado por um objeto de dispositivo.

Sintaxe

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

Parâmetros

[in] DataBlockObject

Ponteiro para um objeto de bloco de dados WMI. O chamador abre o objeto de bloco de dados para a classe WMI com IoWMIOpenBlock.

[in] DeviceObject

Especifica um objeto de dispositivo. A rotina retorna o nome da instância do driver correspondente ao objeto do dispositivo.

[out] InstanceName

Ponteiro para a estrutura UNICODE_STRING que a rotina usa para retornar o nome da instância. O chamador libera o buffer retornado em UNICODE_STRING.

Retornar valor

A rotina retorna um código NTSTATUS. Os possíveis valores retornados incluem:

Código de retorno	Descrição
STATUS_SUCCESS	A operação foi realizada com êxito. A rotina armazena o nome da instância no UNICODE_STRING especificado pelo parâmetro InstanceName .
STATUS_WMI_INSTANCE_NOT_FOUND	O driver não implementa nenhuma instância da classe WMI especificada por DataBlockObject.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows XP e versões posteriores do sistema operacional Windows.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Confira também

DEVICE_OBJECT

IoWMIHandleToInstanceName

IoWMIOpenBlock

Compartilhar via