WdfPdoUpdateAddressDescription 함수(wdfpdo.h)

  • 아티클

[KMDF에만 적용]

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

구문

NTSTATUS WdfPdoUpdateAddressDescription(
  [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
 디바이스 핸들은 동적으로 열거된 디바이스를 나타내지 않거나 지정된 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 구조의 Size 멤버가 디바이스의 기존 주소 설명 크기와 일치하지 않는 경우 입니다.
 

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

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

요구 사항

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

추가 정보

WdfPdoRetrieveAddressDescription