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

2025-02-07

[Solo se aplica a KMDF]

El EvtWmiInstanceSetItem de un controlador función de devolución de llamada 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 WmiDataId valor 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(estado) es igual a FALSE. Si el búfer de entrada al que apunta el inBuffer parámetro 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.

Observaciones

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 de trabajo 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 demás funciones de devolución de llamada de eventos del controlador. Si un EvtWmiInstanceSetItem los datos de la función de devolución de llamada son dinámicos y se comparten con otras funciones de devolución de llamada, el controlador puede usar los bloqueos de espera del marco o bloqueos de giro para sincronizar el acceso a los datos.

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