EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS 콜백 함수(wdffdo.h)

[KMDF에만 적용]

드라이버의 EvtDeviceFilterAddResourceRequirements 이벤트 콜백 함수는 시스템이 디바이스에 리소스를 할당하기 전에 하드웨어 리소스 요구 사항 집합에 리소스를 추가할 수 있습니다.

드라이버의 EvtDeviceFilterRemoveResourceRequirements 이벤트 콜백 함수는 시스템에서 디바이스에 리소스를 할당하기 전에 하드웨어 리소스 요구 사항 집합에서 리소스를 제거할 수 있습니다.

구문

EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS EvtWdfDeviceFilterResourceRequirements;

NTSTATUS EvtWdfDeviceFilterResourceRequirements(
  [in] WDFDEVICE Device,
  [in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}

매개 변수

[in] Device

리소스가 할당될 프레임워크 디바이스 개체에 대한 핸들입니다.

[in] IoResourceRequirementsList

디바이스의 리소스 요구 사항 목록을 나타내는 resource-requirements-list 개체에 대한 핸들입니다.

반환 값

드라이버에 오류가 발생하지 않으면 STATUS_SUCCESS 반환해야 합니다. 그렇지 않으면 NT_SUCCESS FALSE로 평가되는 NTSTATUS 값을 반환 해야 합니다.

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

설명

프레임워크 기반 함수 드라이버는 EvtDeviceFilterAddResourceRequirements 및 EvtDeviceFilterRemoveResourceRequirementscallback 함수를 제공할 수 있습니다. 이러한 콜백 함수를 등록하기 위해 드라이버는 WdfFdoInitSetEventCallbacks를 호출합니다.

프레임워크가 드라이버의 EvtDeviceFilterAddResourceRequirements 콜백 함수를 호출하는 경우 드라이버는 논리 구성에 리소스 설명자를 추가할 수 있으며 추가 논리 구성을 제공할 수 있습니다. 이러한 추가된 항목은 함수 드라이버가 디바이스를 작동시키는 데 필요한 리소스를 나타냅니다.

드라이버의 EvtDeviceFilterAddResourceRequirements 콜백 함수가 디바이스의 리소스 요구 사항 목록에 항목을 추가하고 PnP 관리자가 디바이스의 요구 사항 목록에 리소스를 할당하는 경우 드라이버의 EvtDeviceRemoveAddedResources 콜백 함수는 디바이스의 리소스 목록에서 추가된 리소스를 제거해야 합니다.

리소스 요구 사항 목록에서 항목을 추가하거나 제거하기 위해 드라이버는 IoResourceRequirementsList 매개 변수로 표시되는 resource-requirements-list 개체를 조작하는 프레임워크 resource-requirements-list 개체 메서드 및 프레임워크 resource-range-list 개체 메서드를 호출합니다.

이러한 콜백 함수에 대한 자세한 내용은 리소스 요구 사항 목록 수정을 참조하세요.

하드웨어 리소스 및 리소스 요구 사항 목록에 대한 자세한 내용은 Framework-Based 드라이버용 하드웨어 리소스를 참조하세요.

요구 사항

대상 플랫폼	유니버설
최소 KMDF 버전	1.0
헤더	wdffdo.h(Wdf.h 포함)
IRQL	PASSIVE_LEVEL

참고 항목

EvtDeviceRemoveAddedResources