다음을 통해 공유


WdfIoResourceListGetDescriptor 함수(wdfresource.h)

[KMDF에만 적용]

WdfIoResourceListGetDescriptor 메서드는 리소스 요구 사항 목록의 논리적 구성에 포함된 리소스 설명자에 대한 포인터를 반환합니다.

구문

PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
  [in] WDFIORESLIST ResourceList,
  [in] ULONG        Index
);

매개 변수

[in] ResourceList

디바이스에 대한 하드웨어 리소스의 논리적 구성을 나타내는 프레임워크 resource-range-list 개체에 대한 핸들입니다.

[in] Index

ResourceList가 지정하는 논리 구성의 인덱스로 사용되는 0부터 시작하는 값입니다.

반환 값

WdfIoResourceListGetDescriptor인덱스 값이 유효한 경우 Index 매개 변수가 식별하는 하드웨어 리소스를 설명하는 IO_RESOURCE_DESCRIPTOR 구조체에 대한 포인터를 반환합니다. 그렇지 않으면 메서드는 NULL을 반환합니다.

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

설명

드라이버는 WdfIoResourceListGetDescriptor가 검색하는 IO_RESOURCE_DESCRIPTOR 구조체의 내용을 수정할 수 없습니다. 리소스 설명자를 수정하기 위해 드라이버는 WdfIoResourceListUpdateDescriptor를 호출할 수 있습니다.

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

예제

WdfIoResourceListGetDescriptor를 사용하는 코드 예제는 WdfIoResourceRequirementsListGetIoResList를 참조하세요.

요구 사항

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

추가 정보

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor