[KMDF에만 적용]
WdfPdoRetrieveIdentificationDescription 메서드는 지정된 프레임워크 디바이스 개체와 연결된 식별 설명 검색합니다.
구문론
NTSTATUS WdfPdoRetrieveIdentificationDescription(
[in] WDFDEVICE Device,
[in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);
매개 변수
[in] Device
디바이스의 PDO(물리적 디바이스 개체)를 나타내는 프레임워크 디바이스 개체에 대한 핸들입니다.
[in, out] IdentificationDescription
식별 설명을 받을 호출자 할당 버퍼에 대한 포인터입니다. ID 설명에는 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조가 포함되어야 합니다.
반환 값
작업이 성공하면 함수는 STATUS_SUCCESS 반환합니다. 추가 반환 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
디바이스 핸들이 PDO를 나타내지 않습니다. |
|
디바이스 핸들은 동적으로 열거된 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 구조에 올바른 버퍼 크기가 없는 디바이스를 나타내지 않습니다. |
이 메서드는 다른NTSTATUS 값을 반환할 수도 있습니다.
드라이버가 잘못된 개체 핸들을 제공하는 경우 시스템 버그 검사가 발생합니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 헤더 | wdfpdo.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | <= 디스패치_레벨 |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |