fungsi WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER (wdfwmi.h)

Artikel
02/29/2024

[Hanya berlaku untuk KMDF]

Fungsi WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER menginisialisasi struktur WDF_WMI_INSTANCE_CONFIG dan menyimpan handel tertentu ke objek penyedia WMI.

Sintaks

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

Parameter

[out] Config

Penunjuk ke struktur WDF_WMI_INSTANCE_CONFIG .

[in] Provider

Handel ke objek penyedia WMI yang diperoleh driver dengan panggilan sebelumnya ke WdfWmiProviderCreate.

Nilai kembali

Tidak ada

Keterangan

Fungsi WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER nol struktur WDF_WMI_INSTANCE_CONFIG yang ditentukan parameter Konfigurasi dan mengatur anggota Ukurannya . Fungsi ini juga mengatur anggota Penyedia struktur ke handel yang ditentukan parameter Penyedia .

Driver Anda harus memanggil WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER untuk menginisialisasi struktur WDF_WMI_INSTANCE_CONFIG jika memanggil WdfWmiProviderCreate sebelum memanggil WdfWmiInstanceCreate.

Contoh

Contoh kode berikut menginisialisasi struktur WDF_WMI_PROVIDER_CONFIG dan memanggil WdfWmiProviderCreate. Kemudian, contoh menginisialisasi struktur WDF_WMI_INSTANCE_CONFIG dan memanggil 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;
}