EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY 콜백 함수(wdfpdo.h)
[KMDF에만 적용]
버스 드라이버의 EvtDeviceResourceRequirementsQuery 이벤트 콜백 함수는 디바이스의 필수 하드웨어 리소스를 나타내는 리소스 요구 사항 목록을 만듭니다.
구문
EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;
NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
[in] WDFDEVICE Device,
[in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
[in] IoResourceRequirementsList
빈 리소스 요구 사항 목록을 나타내는 프레임워크 resource-requirements-list 개체에 대한 핸들입니다.
반환 값
드라이버에 오류가 발생하지 않은 경우 필요한 하드웨어 리소스를 지정하는지 여부에 관계없이 STATUS_SUCCESS 반환해야 합니다. 드라이버에 오류가 발생하면 NT_SUCCESS FALSE로 평가되는 NTSTATUS 값을 반환해야 합니다.
이 콜백 함수의 반환 값에 대한 자세한 내용은 보고 디바이스 오류를 참조하세요.
설명
프레임워크 기반 버스 드라이버는 EvtDeviceResourceRequirementsQuery 콜백 함수를 제공할 수 있습니다. 이 콜백 함수를 등록하기 위해 버스 드라이버는 WdfPdoInitSetEventCallbacks를 호출합니다.
프레임워크는 버스 드라이버의 EvtDeviceResourceRequirementsQuery 콜백 함수를 호출하여 디바이스에 대한 리소스 요구 사항 목록을 가져옵니다.
드라이버는 제공된 resource-requirements-list 개체를 디바이스가 제대로 작동할 수 있도록 하는 하드웨어 리소스의 논리적 구성으로 채워야 합니다.
리소스 요구 사항 목록을 만들기 위해 드라이버는 논리 구성에 리소스 설명자를 추가하는 프레임워크 resource-range-list 개체 메서드와 리소스 요구 사항 목록에 논리 구성을 추가하는 프레임워크 resource-requirements-list 개체 메서드를 호출합니다.
하드웨어 리소스 및 리소스 요구 사항 목록 만들기에 대한 자세한 내용은 Framework-Based 드라이버용 하드웨어 리소스를 참조하세요.
드라이버가 Windows 7 이전의 운영 체제 버전에서 실행되는 경우 버스 드라이버는 EvtDeviceResourceRequirementsQuery 를 사용하여 자식 디바이스에서 디바이스 속성을 설정한 후 자식 디바이스를 열거할 수 있습니다.
Windows 7 이상에서 디바이스 속성을 설정하기 위해 버스 드라이버는 IRP_MN_DEVICE_ENUMERATED전처리 루틴을 제공할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 머리글 | wdfpdo.h(Wdf.h 포함) |
| IRQL | PASSIVE_LEVEL |