WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER-Funktion (wdfwmi.h)

Artikel
03/01/2024

[Gilt nur für KMDF]

Die WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER-Funktion initialisiert eine WDF_WMI_INSTANCE_CONFIG-Struktur und speichert ein angegebenes Handle in einem WMI-Anbieterobjekt.

Syntax

void WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER(
  [out] PWDF_WMI_INSTANCE_CONFIG Config,
  [in]  WDFWMIPROVIDER           Provider
);

Parameter

[out] Config

Ein Zeiger auf eine WDF_WMI_INSTANCE_CONFIG-Struktur .

[in] Provider

Ein Handle für ein WMI-Anbieterobjekt, das der Treiber durch einen vorherigen Aufruf von WdfWmiProviderCreate abgerufen hat.

Rückgabewert

Keine

Bemerkungen

Die WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER-Funktion nullt die WDF_WMI_INSTANCE_CONFIG Struktur, die der Config-Parameter angibt, und legt den Size-Member fest. Diese Funktion legt auch den Provider-Member der Struktur auf das Handle fest, das der Provider-Parameter angibt.

Ihr Treiber sollte WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER aufrufen, um eine WDF_WMI_INSTANCE_CONFIG-Struktur zu initialisieren, wenn er WdfWmiProviderCreate vor dem Aufruf von WdfWmiInstanceCreate aufruft.

Beispiele

Im folgenden Codebeispiel wird eine WDF_WMI_PROVIDER_CONFIG-Struktur initialisiert und WdfWmiProviderCreate aufgerufen. Anschließend initialisiert das Beispiel eine WDF_WMI_INSTANCE_CONFIG-Struktur und ruft WdfWmiInstanceCreate auf.

WDF_WMI_PROVIDER_CONFIG  providerConfig;
WDFWMIPROVIDER  provider;
GUID  providerGuid = MY_WMI_DATA_BLOCK_GUID;
WDF_WMI_INSTANCE_CONFIG  instanceConfig;
WDFWMIINSTANCE  instanceHandle;
NTSTATUS  status;

WDF_WMI_PROVIDER_CONFIG_INIT(
                             &providerConfig,
                             providerGuid
                             );
providerConfig.Flags = WdfWmiProviderTracing;
providerConfig.EvtWmiProviderFunctionControl = MyProviderFunctionControl;

status = WdfWmiProviderCreate(
                              Device,
                              &providerConfig,
                              WDF_NO_OBJECT_ATTRIBUTES,
                              &provider
                              );

if (!NT_SUCCESS(status)) {
    return status;
}
WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER(
                                      &instanceConfig,
                                      provider
                                      );
status = WdfWmiInstanceCreate(
                              Device,
                              &instanceConfig,
                              WDF_NO_OBJECT_ATTRIBUTES,
                              &instanceHandle
                              );
if (!NT_SUCCESS(status)) {
    return status;
}