EVT_WDF_WMI_INSTANCE_SET_ITEM función de devolución de llamada (wdfwmi.h)

Artículo
08/08/2023

[Solo se aplica a KMDF]

La función de devolución de llamada EvtWmiInstanceSetItem de un controlador establece un único elemento de los datos de instancia de un proveedor de datos WMI en un valor que proporciona un cliente WMI.

Sintaxis

EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;

NTSTATUS EvtWdfWmiInstanceSetItem(
  [in] WDFWMIINSTANCE WmiInstance,
  [in] ULONG DataItemId,
  [in] ULONG InBufferSize,
  [in] PVOID InBuffer
)
{...}

Parámetros

[in] WmiInstance

Identificador de un objeto de instancia de WMI.

[in] DataItemId

Valor que identifica un elemento de datos para una instancia de proveedor. Este valor corresponde al valor WmiDataId especificado en el archivo MOF del proveedor.

[in] InBufferSize

Tamaño, en bytes, del búfer de entrada al que apunta InBuffer .

[in] InBuffer

Puntero al búfer de entrada.

Valor devuelto

La función de devolución de llamada EvtWmiInstanceSetItem debe devolver STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE. Si el búfer de entrada al que apunta el parámetro InBuffer es demasiado pequeño para contener todos los datos que espera el controlador, la función de devolución de llamada debe devolver STATUS_WMI_SET_FAILURE.

Comentarios

Para registrar una función de devolución de llamada EvtWmiInstanceSetItem , el controlador debe colocar la dirección de la función en una estructura de WDF_WMI_INSTANCE_CONFIG antes de llamar a WdfWmiInstanceCreate.

El marco no sincroniza las llamadas a las funciones de devolución de llamada de eventos WMI de un controlador entre sí o con cualquiera de las otras funciones de devolución de llamada de eventos del controlador. Si los datos de una función de devolución de llamada EvtWmiInstanceSetItem son dinámicos y se comparten con otras funciones de devolución de llamada, el controlador puede usar los bloqueos de espera o los bloqueos de número del marco para sincronizar el acceso a los datos.

Para obtener más información sobre la función de devolución de llamada EvtWmiInstanceSetItem , vea Compatibilidad con WMI en controladores de Framework-Based.