WdfCmResourceListRemove 함수(wdfresource.h)

[KMDF에만 적용]

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

통사론

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

매개 변수

[in] List

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

[in] Index

목록 지정하는 리소스 목록의 인덱스로 사용되는 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
                            );
...

}

요구 사항

참고 항목

WdfCmResourceListRemoveByDescriptor