다음을 통해 공유

WdfPdoRetrieveIdentificationDescription 함수(wdfpdo.h)

  • 아티클

[KMDF에만 적용]

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

구문

NTSTATUS WdfPdoRetrieveIdentificationDescription(
  [in]      WDFDEVICE                                    Device,
  [in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

매개 변수

[in] Device

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

[in, out] IdentificationDescription

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

반환 값

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

반환 코드 설명
STATUS_INVALID_PARAMETER
 디바이스 핸들은 PDO를 나타내지 않습니다.
STATUS_INVALID_DEVICE_REQUEST
 디바이스 핸들은 동적으로 열거된 디바이스를 나타내지 않거나 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조에 올바른 버퍼 크기가 포함되어 있지 않은 경우 입니다.
 

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

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

요구 사항

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

추가 정보

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfPdoRetrieveAddressDescription