Compartir a través de

Función IoWMISuggestInstanceName (wdm.h)

  • Artículo

La rutina IoWMISuggestInstanceName se usa para solicitar que WMI sugiera un nombre base que un controlador puede usar para crear nombres de instancia de WMI para el dispositivo.

Sintaxis

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

Parámetros

[in, optional] PhysicalDeviceObject

Si se proporciona, apunta al objeto de dispositivo físico del controlador.

[in, optional] SymbolicLinkName

Si se proporciona, apunta al nombre del vínculo simbólico devuelto de IoRegisterDeviceInterface.

[in] CombineNames

Si TRUE, los nombres sugeridos devueltos combinarán el PhysicalDeviceObject y SymbolicLinkName información.

[out] SuggestedInstanceName

Un puntero a un búfer que al finalizar correctamente contendrá un UNICODE_STRING que contiene el nombre de instancia sugerido. El autor de la llamada es responsable de liberar este búfer cuando ya no es necesario.

Valor devuelto

IoWMISuggestInstanceName devuelve un código de estado de la lista siguiente:

Código devuelto Descripción
STATUS_SUCCESS
 Indica que WMI pudo completar correctamente esta función.
STATUS_UNSUCCESSFUL
 Indica que los servicios WMI no están disponibles.
STATUS_INSUFFICIENT_RESOURCES
 Indica que los recursos insuficientes estaban disponibles para proporcionar al autor de la llamada un búfer que contiene la cadena Unicode.
STATUS_NO_MEMORY
 Indica que los recursos insuficientes estaban disponibles para proporcionar al autor de la llamada un búfer que contiene la cadena Unicode.

Observaciones

Si parámetro CombineNames es TRUE debe especificarse tanto PhysicalDeviceObject como SymbolicLinkName. De lo contrario, solo se debe especificar una de ellas.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible a partir de Windows 2000.
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

IoWMIAllocateInstanceIds