EVT_WDF_WMI_INSTANCE_QUERY_INSTANCE funzione di callback (wdfwmi.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Un driver EvtWmiInstanceQueryInstance funzione di callback copia i dati dell'istanza di un provider WMI in un buffer per il recapito a un client WMI.

Sintassi

EVT_WDF_WMI_INSTANCE_QUERY_INSTANCE EvtWdfWmiInstanceQueryInstance;

NTSTATUS EvtWdfWmiInstanceQueryInstance(
  [in]  WDFWMIINSTANCE WmiInstance,
  [in]  ULONG OutBufferSize,
  [in]  PVOID OutBuffer,
  [out] PULONG BufferUsed
)
{...}

Parametri

[in] WmiInstance

Handle per un oggetto istanza WMI.

[in] OutBufferSize

Dimensioni, in byte, del buffer di output a cui OutBuffer punta.

[in] OutBuffer

Puntatore al buffer di output.

[out] BufferUsed

Puntatore a una posizione che riceve il numero di byte inseriti dal driver nel buffer di output. Se la dimensione del buffer di output specificata dal parametro OutBufferSize è troppo piccola, il driver imposta questa posizione sulla dimensione del buffer richiesta.

Valore restituito

L'EvtWmiInstanceQueryInstance funzione di callback deve restituire STATUS_BUFFER_TOO_SMALL, se il valore del parametro OutBufferSize indica che il buffer di output è troppo piccolo per ricevere i dati. In caso contrario, la funzione di callback deve copiare i dati nel buffer e restituire STATUS_SUCCESS.

Osservazioni

Per registrare un EvtWmiInstanceQueryInstance funzione di callback, il driver deve inserire l'indirizzo della funzione in una struttura WDF_WMI_INSTANCE_CONFIG prima di chiamare WdfWmiInstanceCreate.

Prima che il framework invii i dati dell'istanza fornita dal driver al client WMI, aggiunge ai dati tutte le informazioni necessarie sull'intestazione WMI.

Se il driver imposta il UseContextForQuery membro della struttura di WDF_WMI_INSTANCE_CONFIG dell'oggetto dell'istanza WMI su TRUE per un blocco di dati di sola lettura, il driver non fornisce un EvtWmiInstanceQueryInstance funzione di callback.

Se il driver deve fornire dati stringa a un client WMI, il driver deve chiamare la funzione WDF_WMI_BUFFER_APPEND_STRING per formattare la stringa.

Per altre informazioni sulla funzione di callback EvtWmiInstance EvtWmiInstance, vedere blocchi di dati WMI di lettura/scrittura e supporto di blocchi di dati WMI Read-Only.

Il framework non sincronizza le chiamate alle funzioni di callback degli eventi WMI di un driver l'una con l'altra o con qualsiasi altra funzione di callback degli eventi del driver. Se un EvtWmiInstanceQueryInstance dati della funzione di callback è dinamico e condiviso con altre funzioni di callback, il driver può usare i blocchi di attesa del framework o i blocchi di selezione per sincronizzare l'accesso ai dati.

Per altre informazioni su WMI, vedere Supporto di WMI in Framework-Based driver.