WdfChildListRetrieveAddressDescription 함수(wdfchildlist.h)
[KMDF에만 적용]
WdfChildListRetrieveAddressDescription 메서드는 지정된 식별 설명 있는 자식 디바이스를 찾고 디바이스의 주소 설명검색합니다.
통사론
NTSTATUS WdfChildListRetrieveAddressDescription(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription,
[in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);
매개 변수
[in] ChildList
자식 목록 개체에 대한 핸들입니다.
[in] IdentificationDescription
드라이버 제공 자식 식별 설명을 식별하는 호출자가 할당한 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조체에 대한 포인터입니다.
[in, out] AddressDescription
자식 주소 설명을 식별하는 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 구조체에 대한 포인터입니다. 프레임워크는 이 설명을 채웁니다.
반환 값
WdfChildListRetrieveAddressDescription STATUS_SUCCESS 반환하거나 작업이 성공하면 NT_SUCCESS(status)가 true 같은 다른 상태 값을 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 묘사 |
|---|---|
|
입력 매개 변수가 잘못되었습니다. |
|
지정된 식별 설명과 일치하는 디바이스가 없습니다. |
|
자식 목록에 주소 설명이 없거나 addressDescription 지정한 주소 설명의 크기가 잘못되었습니다. |
이 메서드는 다른NTSTATUS 값을 반환할 수도 있습니다.
드라이버가 잘못된 개체 핸들을 제공하는 경우 시스템 버그 검사가 발생합니다.
발언
자식 목록에 대한 자세한 내용은 동적 열거형참조하세요.
예제
다음 코드 예제에서는 식별 설명에 SomeValue지정된 값이 포함된 자식 디바이스에 대한 자식 목록을 검색합니다. WdfChildListRetrieveAddressDescription 디바이스를 찾으면 디바이스의 주소 설명을 검색합니다.
MY_IDENTIFICATION_DESCRIPTION id;
MY_ADDRESS_DESCRIPTION addrDescrip;
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(
&id.Header,
sizeof(id)
);
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT(
&addrDescrip.Header,
sizeof(addrDescrip)
);
id.DeviceIdentifier = SomeValue;
status = WdfChildListRetrieveAddressDescription(
list,
&idDescrip.Header,
&addrDescrip.Header
);
if (!NT_SUCCESS(status) {
return status;
}
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 헤더 | wdfchildlist.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
참고 항목
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT