EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD funzione di callback (wdfwmi.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il driver EvtWmiInstanceExecuteMethod funzione di callback esegue un metodo specificato fornito dal driver per l'istanza di un provider di dati WMI.

Sintassi

EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD EvtWdfWmiInstanceExecuteMethod;

NTSTATUS EvtWdfWmiInstanceExecuteMethod(
  [in]      WDFWMIINSTANCE WmiInstance,
  [in]      ULONG MethodId,
  [in]      ULONG InBufferSize,
  [in]      ULONG OutBufferSize,
  [in, out] PVOID Buffer,
  [out]     PULONG BufferUsed
)
{...}

Parametri

[in] WmiInstance

Handle per un oggetto istanza WMI.

[in] MethodId

Valore che identifica un metodo in un'istanza del provider. Questo valore corrisponde al valore wmiMethodId specificato nel file MOF del provider.

[in] InBufferSize

Numero di byte di dati di input.

[in] OutBufferSize

Numero di byte di dati di output che il buffer che Buffer può contenere.

[in, out] Buffer

Puntatore a un buffer utilizzato per l'input, l'output o entrambi, come determinato dal metodo specificato. Se vengono forniti sia i dati di input che di output, il driver sovrascrive i dati di input con i dati di output.

[out] BufferUsed

Puntatore a una posizione che riceve il numero di byte scritti 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

La EvtWmiInstanceExecuteMethod funzione di callback deve restituire STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione deve restituire un valore di stato per il quale NT_SUCCESS( stato) è uguale a FALSE. Il driver deve restituire STATUS_BUFFER_TOO_SMALL se il valore del parametro OutBufferSize indica che il buffer di output è troppo piccolo per ricevere i dati.

Osservazioni

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

Dopo che un driver esegue il metodo di istanza specificato dal parametro MethodId, il driver deve utilizzare il parametro BufferUsed per archiviare il numero di byte scritti nel buffer.

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 EvtWmiInstanceExecuteMethod 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 sulla funzione di callback EvtWmiInstanceExecuteMethod, vedere Supporto di WMI nei driver Framework-Based.