WdfChildListRequestChildEject 함수(wdfchildlist.h)

  • 아티클

[KMDF에만 적용]

WdfChildListRequestChildEject 메서드는 지정된 디바이스가 도킹 스테이션에서 배출될 예정임을 프레임워크에 알릴 수 있습니다.

구문

BOOLEAN WdfChildListRequestChildEject(
  [in] WDFCHILDLIST                                 ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

매개 변수

[in] ChildList

자식 목록 개체에 대한 핸들입니다.

[in] IdentificationDescription

호출자가 할당한 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조체에 대한 포인터입니다.

반환 값

작업이 성공하면 WdfChildListRequestChildEject가 TRUE를 반환합니다. 입력 매개 변수가 유효하지 않거나 프레임워크가 자식 목록에서 디바이스를 찾을 수 없는 경우 메서드는 FALSE를 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 시스템 버그 검사 발생합니다.

설명

버스 드라이버는 WdfChildListRequestChildEject 또는 WdfPdoRequestEject 를 호출하여 드라이버가 디바이스의 도킹 스테이션에서 열거된 자식 디바이스 중 하나를 꺼내려는 시도를 감지했다고 보고할 수 있습니다. 예를 들어 드라이버는 사용자가 배출 단추를 누름을 감지할 수 있습니다.

드라이버가 동적 버스 열거형을 사용하고 디바이스의 ID 설명을 사용할 수 있는 경우 드라이버는 WdfChildListRequestChildEject를 호출할 수 있습니다. 디바이스의 PDO에 대한 프레임워크 디바이스 개체를 사용할 수 있는 경우 드라이버는 WdfPdoRequestEject를 호출할 수 있습니다.

WdfChildListRequestChildEject 메서드의 IdentificationDescription 매개 변수는 배출되는 디바이스를 식별합니다. 디바이스는 ChildList 매개 변수가 나타내는 자식 목록의 멤버여야 합니다.

프레임워크는 식별 설명을 사용하여 자식 목록에서 디바이스를 찾습니다.

자식 목록에 대한 자세한 내용은 동적 열거형을 참조하세요.

꺼내기 가능한 디바이스에 대한 자세한 내용은 꺼내 기 가능 디바이스 지원을 참조하세요.

예제

WdfChildListRequestChildEject를 사용하는 코드 예제는 WdfChildListRetrieveNextDevice를 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfchildlist.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL <= DISPATCH_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfPdoRequestEject