EVT_WDF_WMI_INSTANCE_SET_INSTANCE función de devolución de llamada (wdfwmi.h)
[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.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfwmi.h (incluir Wdf.h) |
| IRQL | PASSIVE_LEVEL |