EVT_WDF_CHILD_LIST_CREATE_DEVICE fungsi panggilan balik (wdfchildlist.h)

Artikel
02/29/2024

[Hanya berlaku untuk KMDF]

Fungsi panggilan balik peristiwaEvtChildListCreateDevice driver bus membuat objek perangkat kerangka kerja untuk perangkat baru yang telah dijumlahkan secara dinamis.

Sintaks

EVT_WDF_CHILD_LIST_CREATE_DEVICE EvtWdfChildListCreateDevice;

NTSTATUS EvtWdfChildListCreateDevice(
  [in] WDFCHILDLIST ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription,
  [in] PWDFDEVICE_INIT ChildInit
)
{...}

Parameter

[in] ChildList

Handel ke objek daftar turunan kerangka kerja yang ditentukan driver saat disebut WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] IdentificationDescription

Penunjuk ke salinan struktur WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER yang ditentukan driver saat disebut WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] ChildInit

Penunjuk ke struktur WDFDEVICE_INIT .

Mengembalikan nilai

Fungsi panggilan balik EvtChildListCreateDevice harus mengembalikan STATUS_SUCCESS, atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE, jika operasi berhasil. Jika tidak, fungsi ini harus mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE.

Jika operasi gagal tetapi Menurut Anda driver Anda harus mencoba lagi nanti, dan jika fungsi panggilan balik EvtChildListCreateDevice driver belum disebut WdfDeviceCreate, driver dapat mengembalikan STATUS_RETRY. Akibatnya, kerangka kerja memanggil fungsi panggilan balik EvtChildListCreateDevice lagi nanti. Jika driver Anda kembali STATUS_RETRY lebih dari beberapa kali, kerangka kerja akan berhenti memanggil fungsi panggilan balik untuk perangkat yang gagal.

Keterangan

Jika driver bus menggunakan enumerasi dinamis, driver dapat mendaftarkan fungsi panggilan balik EvtChildListCreateDevice dengan memanggil WdfFdoInitSetDefaultChildListConfig atau WdfChildListCreate.

Setelah driver memanggil WdfChildListAddOrUpdateChildDescriptionAsPresent atau WdfChildListUpdateAllChildDescriptionsAsPresent, kerangka kerja memanggil fungsi panggilan balik EvtChildListCreateDevice driver. Fungsi panggilan balik harus memanggil WdfDeviceCreate untuk membuat objek perangkat kerangka kerja (PDO).

Sebelum memanggil WdfDeviceCreate, driver harus memanggil fungsi yang disediakan kerangka kerja yang menginisialisasi struktur WDFDEVICE_INIT. Untuk informasi selengkapnya tentang fungsi-fungsi ini, lihat WDFDEVICE_INIT.

Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.

Untuk informasi selengkapnya tentang enumerasi dinamis, lihat Menghitung Perangkat di Bus.