EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP 콜백 함수(wdfchildlist.h)

아티클
02/26/2024

[KMDF에만 적용]

드라이버의 EvtChildListIdentificationDescriptionCleanup 이벤트 콜백 함수는 드라이버의 EvtChildListIdentificationDescriptionDuplicate 콜백 함수가 할당된 식별 설명에 대한 메모리 할당을 해제합니다.

구문

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP EvtWdfChildListIdentificationDescriptionCleanup;

void EvtWdfChildListIdentificationDescriptionCleanup(
  [in]      WDFCHILDLIST ChildList,
  [in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
)
{...}

매개 변수

[in] ChildList

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

[in, out] IdentificationDescription

식별 설명을 식별하는 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조체에 대한 포인터입니다.

반환 값

없음

설명

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

ID 설명이 동적으로 할당된 메모리에 저장된 추가 정보를 가리키고 해당 메모리가 EvtChildListIdentificationDescriptionDuplicate 콜백 함수에 의해 할당되는 경우 드라이버는 EvtChildListIdentificationDescriptionCleanup 콜백 함수를 제공해야 합니다.

일반적으로 EvtChildListIdentificationDescriptionDuplicate 콜백 함수는 ExAllocatePool을 호출하여 메모리를 할당합니다. EvtChildListIdentificationDescriptionCleanup 콜백 함수는 ExFreePool을 호출하여 해당 메모리의 할당을 취소해야 합니다. 이 콜백 함수는 식별 설명의 나머지 부분을 할당 취소하려고 시도해서는 안 됩니다. 즉, 콜백 함수는 IdentificationDescription 매개 변수가 가리키는 주소 설명 구조의 할당을 취소하면 안 됩니다. 설명 구조가 가리키는 추가 메모리 할당만 할당 취소해야 합니다.

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