EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY 콜백 함수(wdfchildlist.h)

아티클
08/08/2023

[KMDF에만 적용]

드라이버의 EvtChildListIdentificationDescriptionCopy 이벤트 콜백 함수는 지정된 위치에서 다른 위치로 자식 식별 설명을 복사합니다.

구문

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY EvtWdfChildListIdentificationDescriptionCopy;

void EvtWdfChildListIdentificationDescriptionCopy(
  [in]  WDFCHILDLIST ChildList,
  [in]  PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER SourceIdentificationDescription,
  [out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER DestinationIdentificationDescription
)
{...}

매개 변수

[in] ChildList

프레임워크 자식 목록 개체에 대한 핸들입니다.

[in] SourceIdentificationDescription

자식 식별 설명의 원본 위치를 식별하는 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조체에 대한 포인터입니다.

[out] DestinationIdentificationDescription

자식 식별 설명의 대상 위치를 식별하는 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조체에 대한 포인터입니다.

반환 값

없음

설명

버스 드라이버가 동적 열거형을 사용하는 경우 WdfFdoInitSetDefaultChildListConfig 또는 WdfChildListCreate를 호출하여 EvtChildListIdentificationDescriptionCopy 콜백 함수를 등록할 수 있습니다.

프레임워크는 기존 설명을 새 정보로 업데이트해야 하거나 ID 설명의 내용을 드라이버에 전달해야 하는 경우 드라이버에서 제공한 식별 설명의 정보를 다른 정보로 복사합니다.

EvtChildListIdentificationDescriptionCopy 콜백 함수는 원본 설명의 내용을 대상 설명에 복사해야 합니다. 프레임워크가 RtlCopyMemory 를 호출하여 식별 설명을 복사할 수 없는 경우 드라이버는 이 콜백 함수를 제공해야 합니다. 설명에 추가 메모리에 대한 포인터가 포함된 경우 프레임워크에서 RtlCopyMemory 를 호출할 수 없습니다.

드라이버가 EvtChildListIdentificationDescriptionCopy 콜백 함수를 제공하지 않는 경우 프레임워크는 RtlCopyMemory를 호출하여 식별 설명을 복사합니다.

다음 단계에서는 가능한 시나리오를 설명합니다.

자식 목록을 트래버스하는 드라이버는 WdfChildListRetrieveNextDevice를 호출합니다. 드라이버는 자식 디바이스의 식별 설명을 받을 수 있도록 WDF_CHILD_RETRIEVE_INFO 구조를 제공합니다.
프레임워크는 EvtChildListIdentificationDescriptionCopy 콜백 함수(있는 경우) 또는 RtlCopyMemory 를 호출하여 디바이스의 식별 설명을 복사합니다. 복사 작업의 원본은 프레임워크의 설명 내부 복사본입니다. 대상은 드라이버가 할당하고 해당 WDF_CHILD_RETRIEVE_INFO 구조에서 식별한 메모리입니다.

설명이 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조체의 IdentificationDescriptionSize 멤버에 의해 지정된 미리 결정된 크기의 단일 구조로 구성된 경우 프레임워크는 RtlCopyMemory를 사용하여 ID 설명을 복사할 수 있습니다. 그러나 경우에 따라 설명에 동적으로 할당된 메모리에 저장된 추가 정보도 포함되어야 합니다. 이 경우 일반적으로 멤버가 동적으로 할당된 메모리를 가리키도록 설명 구조를 정의하고 드라이버는 EvtChildListIdentificationDescriptionCopy 콜백 함수를 제공해야 합니다. 콜백 함수는 다음을 수행해야 합니다.

콜백 함수의 SourceIdentificationDescription 및 DestinationIdentificationDescription 구조에서 동적으로 할당된 메모리에 대한 포인터를 찾습니다.
포인터를 사용하여 원본에서 대상으로 동적으로 할당된 메모리를 복사합니다.
콜백 함수의 SourceIdentificationDescription 구조체에서 콜백 함수의 DestinationIdentificationDescription 구조체로 다른 구조체 멤버를 복사합니다.

드라이버의 EvtChildListIdentificationDescriptionCopy 콜백 함수가 호출할 수 있는 유일한 프레임워크 자식 목록 개체 메서드는 WdfChildListGetDevice입니다.

프레임워크는 EvtChildListIdentificationDescriptionCopy 콜백 함수를 호출하기 전에 내부 자식 목록 개체 잠금을 획득합니다. 콜백 함수는 프레임워크 메모리 개체 메서드 호출 및 개체 컨텍스트 공간 액세스와 같은 복사 작업과 관련된 작업만 수행해야 합니다. 다른 드라이버에 액세스하는 메서드를 호출해서는 안됩니다.

드라이버가 EvtChildListIdentificationDescriptionCopy 콜백 함수를 제공하는 경우 EvtChildListIdentificationDescriptionDuplicate, EvtChildListIdentificationDescriptionCompare 및 EvtChildListIdentificationDescriptionCleanup 콜백 함수가 필요할 수도 있습니다.

동적 열거형에 대한 자세한 내용은 버스에서 디바이스 열거를 참조하세요.