WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER函式 (wdfwmi.h)

發行項
02/27/2024

[僅適用於 KMDF]

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER函式會初始化WDF_WMI_INSTANCE_CONFIG結構，並將指定的句柄儲存至 WMI 提供者物件。

語法

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

參數

[out] Config

WDF_WMI_INSTANCE_CONFIG 結構的指標。

[in] Provider

由先前呼叫 WdfWmiProviderCreate 取得之驅動程式的 WMI 提供者物件的句柄。

傳回值

無

備註

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER函式會零 Config 參數指定並設定其 Size 成員的WDF_WMI_INSTANCE_CONFIG結構。此函式也會將結構的 Provider 成員設定為 Provider 參數所指定的句柄。

如果驅動程式在呼叫 WdfWmiInstanceCreate 之前呼叫 WdfWmiProviderCreate，則應該呼叫 WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER 來初始化 WDF_WMI_INSTANCE_CONFIG 結構。

範例

下列程式代碼範例會初始化 WDF_WMI_PROVIDER_CONFIG 結構，並呼叫 WdfWmiProviderCreate。然後，此範例會初始化 WDF_WMI_INSTANCE_CONFIG 結構，並呼叫 WdfWmiInstanceCreate。

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;
}