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(상태)가 TRUE와 같은 다른 상태 값을 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.

이 메서드는 다른 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;
}

요구 사항

추가 정보

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT