EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL Rückruffunktion (wdfwmi.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die EvtWmiProviderFunctionControl-Rückruffunktion eines Treibers aktiviert und deaktiviert die Unterstützung des Treibers für das Sammeln von Daten und das Senden von Ereignissen für einen angegebenen WMI-Datenanbieter.

Syntax

EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;

NTSTATUS EvtWdfWmiProviderFunctionControl(
  [in] WDFWMIPROVIDER WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL Control,
  [in] BOOLEAN Enable
)
{...}

Parameter

[in] WmiProvider

Ein Handle für ein WMI-Anbieterobjekt.

[in] Control

Ein WDF_WMI_PROVIDER_CONTROL typisierter Wert, der eine Funktion angibt, die der Treiber aktivieren oder deaktivieren muss.

[in] Enable

Ein boolescher Wert, der bei TRUE angibt, dass der Treiber die von Control festgelegte Funktion aktivieren muss. Bei FALSE muss der Treiber die Funktion deaktivieren.

Rückgabewert

Die Rückruffunktion EvtWmiProviderFunctionControl muss STATUS_SUCCESS zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls muss ein status Wert zurückgegeben werden, für den NT_SUCCESS(status) gleich FALSE ist.

Hinweise

Um eine EvtWmiProviderFunctionControl-Rückruffunktion zu registrieren, muss der Treiber die Adresse der Funktion in einer WDF_WMI_PROVIDER_CONFIG-Struktur platzieren, bevor WdfWmiProviderCreate aufgerufen wird.

Wenn Ihr Treiber das WdfWmiProviderExpensive-Flag im Flags-Member der WDF_WMI_PROVIDER_CONFIG-Struktur eines WMI-Datenanbieters festlegt und der Treiber eine EvtWmiProviderFunctionControl-Rückruffunktion bereitstellt, ruft das Framework die Rückruffunktion auf, wenn der Treiber seine Fähigkeit zum Sammeln von WMI-Daten aktivieren oder deaktivieren soll.

Anstatt eine EvtWmiProviderFunctionControl-Rückruffunktion bereitzustellen, kann der Treiber WdfWmiProviderIsEnabled aufrufen, um herauszufinden, ob das Sammeln von Daten aktiviert oder deaktiviert werden soll.

Weitere Informationen zur Rückruffunktion EvtWmiProviderFunctionControl finden Sie unter Unterstützen von WMI in Framework-Based-Treibern.