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

Artículo
02/29/2024

[Solo se aplica a KMDF]

La función de devolución de llamada EvtWmiInstanceSetInstance de un controlador establece todos los datos de instancia de un proveedor de datos WMI en valores que proporciona un cliente WMI.

Sintaxis

EVT_WDF_WMI_INSTANCE_SET_INSTANCE EvtWdfWmiInstanceSetInstance;

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

Parámetros

[in] WmiInstance

Identificador de un objeto de instancia de WMI.

[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 EvtWmiInstanceSetInstance 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 EvtWmiInstanceSetInstance , 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 EvtWmiInstanceSetInstance 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 EvtWmiInstanceSetInstance , vea Compatibilidad con WMI en controladores de Framework-Based.