다음을 통해 공유

WdfPdoRetrieveAddressDescription 함수(wdfpdo.h)

  • 아티클

[KMDF에만 적용]

WdfPdoRetrieveAddressDescription 메서드는 지정된 프레임워크 디바이스 개체와 연결된 주소 설명을 검색합니다.

구문

NTSTATUS WdfPdoRetrieveAddressDescription(
  [in]      WDFDEVICE                             Device,
  [in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);

매개 변수

[in] Device

디바이스의 PDO(물리적 디바이스 개체)를 나타내는 프레임워크 디바이스 개체에 대한 핸들입니다.

[in, out] AddressDescription

주소 설명을 받을 호출자가 할당한 버퍼에 대한 포인터입니다. 주소 설명에는 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 구조체가 포함되어야 합니다.

반환 값

작업이 성공하면 함수는 STATUS_SUCCESS 반환합니다. 추가 반환 값은 다음과 같습니다.

반환 코드 설명
STATUS_INVALID_PARAMETER
 디바이스 핸들은 PDO를 나타내지 않습니다.
STATUS_INVALID_DEVICE_REQUEST
 디바이스 핸들은 동적으로 열거된 디바이스를 나타내지 않습니다.
 

메서드는 다른 NTSTATUS 값을 반환할 수도 있습니다.

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

요구 사항

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

추가 정보

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WdfChildListRetrieveAddressDescription

WdfPdoRetrieveIdentificationDescription