EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES 콜백 함수(wdffdo.h)

  • 아티클

[KMDF에만 적용]

드라이버의 EvtDeviceRemoveAddedResources 이벤트 콜백 함수는 드라이버의 EvtDeviceFilterAddResourceRequirements 콜백 함수가 추가한 하드웨어 리소스를 제거합니다.

구문

EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;

NTSTATUS EvtWdfDeviceRemoveAddedResources(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST ResourcesRaw,
  [in] WDFCMRESLIST ResourcesTranslated
)
{...}

매개 변수

[in] Device

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

[in] ResourcesRaw

PnP 관리자가 디바이스에 할당한 원시 하드웨어 리소스를 식별하는 리소스 목록 개체에 대한 핸들입니다.

[in] ResourcesTranslated

PnP 관리자가 디바이스에 할당한 변환된 하드웨어 리소스를 식별하는 리소스 목록 개체에 대한 핸들입니다.

반환 값

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

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

설명

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

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

리소스 목록 및 리소스가 표시되는 순서에 대한 자세한 내용은 원시 및 번역된 하드웨어 리소스를 참조하세요.

프레임워크는 디바이스의 리소스 목록을 버스 드라이버에 전달하기 직전에 드라이버의 EvtDeviceRemoveAddedResources 콜백 함수를 호출합니다. 이 콜백 함수는 추가된 리소스를 제거하므로 버스 드라이버가 리소스를 사용하지 않습니다.

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

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

요구 사항

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

추가 정보

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirements