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

추가 정보

EvtDeviceResourcesQuery