struktur WDF_CHILD_RETRIEVE_INFO (wdfchildlist.h)

[Berlaku untuk KMDF saja]

Struktur WDF_CHILD_RETRIEVE_INFO berisi informasi tentang perangkat anak yang diperoleh dengan memanggil WdfChildListRetrieveNextDevice atau WdfChildListRetrievePdo.

Sintaks

typedef struct _WDF_CHILD_RETRIEVE_INFO {
  ULONG                                                 Size;
  PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER          IdentificationDescription;
  PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER                 AddressDescription;
  WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS                 Status;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE EvtChildListIdentificationDescriptionCompare;
} WDF_CHILD_RETRIEVE_INFO, *PWDF_CHILD_RETRIEVE_INFO;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

IdentificationDescription

Penunjuk ke struktur WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER yang dialokasikan driver. Driver harus menyediakan nilai untuk anggota IdentificationDescriptionSize struktur ini.

Jika driver memanggil fungsi panggilan balik WdfChildListRetrieveNextDevice dan menyediakan fungsi panggilan balik EvtChildListIdentificationDescriptionCompare , driver juga harus memberikan deskripsi identifikasi yang dapat digunakan fungsi panggilan balik untuk membandingkan dengan entri dalam daftar anak.

Jika driver memanggil WdfChildListRetrievePdo, driver harus mengisi seluruh deskripsi identifikasi.

AddressDescription

Penunjuk ke struktur WDF_CHILD_ADDRESS_DESCRIPTION_HEADER yang dialokasikan driver. Driver harus menyediakan nilai untuk anggota AddressDescriptionSize struktur ini. Kerangka kerja mengisi sisa deskripsi alamat saat mengambil anak dari daftar anak. Jika nilai AddressDescriptionSize adalah NULL, informasi deskripsi alamat tidak diambil.

Status

Nilai WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS-ketik yang disediakan kerangka kerja.

EvtChildListIdentificationDescriptionCompare

Penunjuk yang disediakan driver ke fungsi panggilan balik EvtChildListIdentificationDescriptionCompare .

Jika driver memanggil WdfChildListRetrieveNextDevice, penunjuk ini bersifat opsional dan dapat berupa NULL.

Jika driver memanggil WdfChildListRetrievePdo, pointer ini tidak digunakan.

Keterangan

Struktur WDF_CHILD_RETRIEVE_INFO diteruskan ke metode WdfChildListRetrieveNextDevice dan WdfChildListRetrievePdo .

Untuk menginisialisasi struktur WDF_CHILD_RETRIEVE_INFO, driver harus memanggil WDF_CHILD_RETRIEVE_INFO_INIT.

Persyaratan

Persyaratan	Nilai
Versi KMDF minimum	1,0
Header	wdfchildlist.h (termasuk Wdf.h)

Lihat juga

EvtChildListIdentificationDescriptionCompare

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo