WDF_CHILD_RETRIEVE_INFO 구조체(wdfchildlist.h)

아티클
08/08/2023

[KMDF에만 적용]

WDF_CHILD_RETRIEVE_INFO 구조에는 WdfChildListRetrieveNextDevice 또는 WdfChildListRetrievePdo를 호출하여 가져온 자식 디바이스에 대한 정보가 포함됩니다.

구문

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;

멤버

Size

이 구조체의 크기(바이트)입니다.

IdentificationDescription

드라이버 할당 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조체에 대한 포인터입니다. 드라이버는 이 구조체의 IdentificationDescriptionSize 멤버에 대한 값을 제공해야 합니다.

드라이버가 WdfChildListRetrieveNextDevice 를 호출하고 EvtChildListIdentificationDescriptionCompare 콜백 함수를 제공하는 경우 드라이버는 콜백 함수가 자식 목록의 항목과 비교하는 데 사용할 수 있는 식별 설명 도 제공해야 합니다.

드라이버가 WdfChildListRetrievePdo를 호출하는 경우 드라이버는 전체 ID 설명을 입력해야 합니다.

AddressDescription

드라이버 할당 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 구조체에 대한 포인터입니다. 드라이버는 이 구조체의 AddressDescriptionSize 멤버에 대한 값을 제공해야 합니다. 프레임워크는 자식 목록에서 자식 을 검색할 때 주소 설명 의 나머지 부분을 채웁니다. AddressDescriptionSize 값이 NULL이면 주소 설명 정보가 검색되지 않습니다.

Status

프레임워크에서 제공하는 WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS 형식의 값입니다.

EvtChildListIdentificationDescriptionCompare

EvtChildListIdentificationDescriptionCompare 콜백 함수에 대한 드라이버 제공 포인터입니다.

드라이버가 WdfChildListRetrieveNextDevice를 호출하는 경우 이 포인터는 선택 사항이며 NULL일 수 있습니다.

드라이버가 WdfChildListRetrievePdo를 호출하는 경우 이 포인터는 사용되지 않습니다.