Função IoWMISuggestInstanceName (wdm.h)

Artigo
02/07/2025

A rotina de IoWMISuggestInstanceName é usada para solicitar que o WMI sugira um nome base que um driver possa usar para criar nomes de instância WMI para o dispositivo.

Sintaxe

NTSTATUS IoWMISuggestInstanceName(
  [in, optional] PDEVICE_OBJECT  PhysicalDeviceObject,
  [in, optional] PUNICODE_STRING SymbolicLinkName,
  [in]           BOOLEAN         CombineNames,
  [out]          PUNICODE_STRING SuggestedInstanceName
);

Parâmetros

[in, optional] PhysicalDeviceObject

Se fornecido, aponta para o objeto de dispositivo físico do driver.

[in, optional] SymbolicLinkName

Se fornecido, aponta para o nome de link simbólico retornado de IoRegisterDeviceInterface.

[in] CombineNames

Se VERDADEIRO, os nomes sugeridos retornados combinarão a PhysicalDeviceObject e informações de SymbolicLinkName.

[out] SuggestedInstanceName

Um ponteiro para um buffer que, após a conclusão bem-sucedida, conterá um UNICODE_STRING que contém o nome da instância sugerida. O chamador é responsável por liberar esse buffer quando ele não é mais necessário.

Valor de retorno

IoWMISuggestInstanceName retorna um código de status da seguinte lista:

Código de retorno	Descrição
STATUS_SUCCESS	Indica que o WMI foi capaz de concluir essa função com êxito.
STATUS_UNSUCCESSFUL	Indica que os serviços WMI não estão disponíveis.
STATUS_INSUFFICIENT_RESOURCES	Indica que recursos insuficientes estavam disponíveis para fornecer ao chamador um buffer que contém a cadeia de caracteres Unicode.
STATUS_NO_MEMORY	Indica que recursos insuficientes estavam disponíveis para fornecer ao chamador um buffer que contém a cadeia de caracteres Unicode.

Observações

Se o parâmetro CombineNames for VERDADEIRO, PhysicalDeviceObject e SymbolicLinkName deverão ser especificados. Caso contrário, apenas um deles deve ser especificado.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 2000.
da Plataforma de Destino	Universal
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

IoWMIAllocateInstanceIds

Partilhar via