Fungsi WdfFdoInitSetDefaultChildListConfig (wdffdo.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfFdoInitSetDefaultChildListConfig mengonfigurasi daftar anak default driver bus.

Sintaks

void WdfFdoInitSetDefaultChildListConfig(
  [in, out]      PWDFDEVICE_INIT        DeviceInit,
  [in]           PWDF_CHILD_LIST_CONFIG Config,
  [in, optional] PWDF_OBJECT_ATTRIBUTES DefaultChildListAttributes
);

Parameter

[in, out] DeviceInit

Penunjuk ke struktur WDFDEVICE_INIT yang diperoleh driver dari fungsi panggilan balik EvtDriverDeviceAdd .

[in] Config

Penunjuk ke struktur WDF_CHILD_LIST_CONFIG yang dialokasikan driver.

[in, optional] DefaultChildListAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan penelepon yang berisi atribut objek untuk objek daftar turunan yang mewakili daftar anak default driver. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.

Nilai kembali

Tidak ada

Keterangan

Driver bus harus memanggil WdfFdoInitSetDefaultChildListConfig sebelum memanggil WdfDeviceCreate untuk objek perangkat fungsional (FDO). Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.

Untuk informasi selengkapnya tentang metode WdfFdoInitSetDefaultChildListConfig , lihat Menghitung Perangkat di Bus.

Contoh

Contoh kode berikut menginisialisasi struktur WDF_CHILD_LIST_CONFIG lalu memanggil WdfFdoInitSetDefaultChildListConfig.

WDF_CHILD_LIST_CONFIG  config;

WDF_CHILD_LIST_CONFIG_INIT(
                           &config,
 sizeof(MY_IDENTIFICATION_DESCRIPTION),
                           My_EvtDeviceListCreatePdo
                           );
config.EvtChildListIdentificationDescriptionDuplicate = My_EvtChildListIdentificationDescriptionDuplicate;
config.EvtChildListIdentificationDescriptionCompare = My_EvtChildListIdentificationDescriptionCompare;
config.EvtChildListIdentificationDescriptionCleanup = My_EvtChildListIdentificationDescriptionCleanup;

WdfFdoInitSetDefaultChildListConfig(
                                    DeviceInit,
                                    &config,
                                    WDF_NO_OBJECT_ATTRIBUTES
                                    );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdffdo.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI ChildListConfiguration(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate