EVT_WDF_DEVICE_RESOURCES_QUERY 콜백 함수(wdfpdo.h)

[KMDF에만 적용]

버스 드라이버의 EvtDeviceResourcesQuery 이벤트 콜백 함수는 지정된 디바이스의 부팅 구성을 나타내는 리소스 목록을 만듭니다.

구문

EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;

NTSTATUS EvtWdfDeviceResourcesQuery(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST Resources
)
{...}

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] Resources

빈 리소스 목록을 나타내는 프레임워크 리소스 목록 개체에 대한 핸들입니다.

반환 값

드라이버에 오류가 발생하지 않은 경우 부팅 구성 리소스를 지정하는지 여부에 관계없이 STATUS_SUCCESS 반환해야 합니다. 드라이버에 오류가 발생하면 NT_SUCCESS FALSE로 평가되는 NTSTATUS 값을 반환해야 합니다.

이 콜백 함수의 반환 값에 대한 자세한 내용은 보고 디바이스 오류를 참조하세요.

설명

프레임워크 기반 버스 드라이버는 EvtDeviceResourcesQuery 콜백 함수를 제공할 수 있습니다. 이 콜백 함수를 등록하기 위해 버스 드라이버는 WdfPdoInitSetEventCallbacks를 호출합니다.

프레임워크는 버스 드라이버의 EvtDeviceResourcesQuery 콜백 함수를 호출하여 디바이스의 부팅 구성을 지정하는 리소스 목록을 가져옵니다.

드라이버는 제공된 리소스 목록 개체를 디바이스의 부팅 요구 사항을 나타내는 하드웨어 리소스로 채워야 합니다. PnP 디바이스용 드라이버는 시스템 BIOS에서 이 요구 사항 정보를 얻습니다.

리소스 목록을 만들기 위해 드라이버는 Resources 매개 변수로 표시되는 resource-list 개체에 리소스를 추가하는 프레임워크 resource-list 개체 메서드를 호출합니다. 하드웨어 리소스 및 리소스 목록 만들기에 대한 자세한 내용은 Framework-Based 드라이버용 하드웨어 리소스를 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
머리글	wdfpdo.h(Wdf.h 포함)
IRQL	PASSIVE_LEVEL

추가 정보

EvtDeviceResourceRequirementsQuery