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

[Solo se aplica a KMDF]

La de un controlador EvtWmiInstanceSetInstance función de devolución de llamada 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(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 EvtWmiInstanceSetInst ance, 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 EvtWmiInstanceSetInstance 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 los bloqueos de número para sincronizar el acceso a los datos.

Para obtener más información sobre la función de devolución de llamada de EvtWmiInstanceSetInst ance, consulte Compatibilidad con WMI en Framework-Based Controladores.

Requisitos

Consulte también

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetItem

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCrear