EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD funzione di callback (wdfwmi.h)

Articolo
02/27/2024

[Si applica solo a KMDF]

La funzione di callback EvtWmiInstanceExecuteMethod di un driver 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 punta a può contenere.

[in, out] Buffer

Puntatore a un buffer utilizzato per input, 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 le dimensioni del buffer di output specificate dal parametro OutBufferSize sono troppo piccole, il driver imposta questa posizione sulle dimensioni del buffer necessarie.

Valore restituito

La funzione di callback EvtWmiInstanceExecuteMethod 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(status) è 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.

Commenti

Per registrare una funzione di callback EvtWmiInstanceExecuteMethod , 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 usare 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 tra loro o con qualsiasi altra funzione di callback degli eventi del driver. Se i dati di una funzione di callback EvtWmiInstanceExecuteMethod sono dinamici e condivisi con altre funzioni di callback, il driver può usare i blocchi di attesa o i blocchi di rotazione del framework per sincronizzare l'accesso ai dati.

Per altre informazioni sulla funzione di callback EvtWmiInstanceExecuteMethod , vedere Supporto di WMI nei driver Framework-Based.