WdfCmResourceListRemove 함수(wdfresource.h)

[KMDF에만 적용]

WdfCmResourceListRemove 메서드는 지정된 리소스 목록에서 리소스 설명자를 제거합니다.

구문

void WdfCmResourceListRemove(
  [in] WDFCMRESLIST List,
  [in] ULONG        Index
);

매개 변수

[in] List

디바이스의 하드웨어 리소스 목록을 나타내는 프레임워크 리소스 목록 개체에 대한 핸들입니다.

[in] Index

List가 지정하는 리소스 목록에 인덱스로 사용되는 0부터 시작하는 값입니다.

반환 값

없음

설명

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

WdfCmResourceListRemove 메서드는 Index 매개 변수가 지정하는 인덱스 값과 연결된 리소스 설명자를 제거합니다.

WdfCmResourceListRemove가 인덱스 값이 n인 리소스 설명자를 제거하면 다음 리소스 설명자의 인덱스 값이 n+1에서 n으로 변경됩니다.

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

예제

다음 코드 예제에서는 EvtDeviceRemoveAddedResources 콜백 함수가 수신하는 원시 및 번역된 하드웨어 리소스 목록에서 세 번째 리소스 설명자를 제거합니다.

NTSTATUS
MyEvtDeviceRemoveAddedResources(
    WDFDEVICE Device,
    WDFCMRESLIST ResourcesRaw,
    WDFCMRESLIST ResourcesTranslated
    )
{
...
    WdfCmResourceListRemove(
                            ResourcesRaw,
                            2
                            );
    WdfCmResourceListRemove(
                            ResourcesTranslated,
                            2
                            );
...

}

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
머리글	wdfresource.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL	<=DISPATCH_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

WdfCmResourceListRemoveByDescriptor