EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL Rückruffunktion (wdfwmi.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die EvtWmiProviderFunctionControl Rückruffunktion eines Treibers aktiviert und deaktiviert die Unterstützung des Treibers zum Sammeln von Daten und 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-typed-Wert, der eine Funktion identifiziert, die der Treiber aktivieren oder deaktivieren muss.

[in] Enable

Ein boolescher Wert, der, wenn TRUE, angibt, dass der Treiber die Funktion aktivieren muss, die Control angibt. Wenn FALSE-, muss der Treiber die Funktion deaktivieren.

Rückgabewert

Die EvtWmiProviderFunctionControl Rückruffunktion muss STATUS_SUCCESS zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls muss ein Statuswert zurückgegeben werden, für den NT_SUCCESS(Status) FALSE-entspricht.

Bemerkungen

Um eine EvtWmiProviderFunctionControl Rückruffunktion zu registrieren, muss der Treiber die Adresse der Funktion in einer WDF_WMI_PROVIDER_CONFIG Struktur platzieren, bevor sie WdfWmiProviderCreateaufruft.

Wenn Ihr Treiber die WdfWmiProviderExpensive Flag im Flags Mitglied der WDF_WMI_PROVIDER_CONFIG Struktur eines WMI-Datenanbieters festlegt und wenn der Treiber eine EvtWmiProviderFunctionControl- Rückruffunktion bereitstellt, ruft das Framework die Rückruffunktion auf, wenn der Treiber die Möglichkeit 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 EvtWmiProviderFunctionControl Rückruffunktion finden Sie unter Unterstützen von WMI in Framework-Based Drivers.