UrsIoResourceListAppendDescriptor 함수(ursdevice.h)
지정된 리소스 설명자를 호스트 또는 함수 역할에 대한 리소스 설명자를 유지하는 지정된 I/O 리소스 목록 개체에 추가합니다.
구문
NTSTATUS UrsIoResourceListAppendDescriptor(
[in] URSIORESLIST IoResourceList,
[in] PIO_RESOURCE_DESCRIPTOR Descriptor
);
매개 변수
[in] IoResourceList
리소스 설명자가 추가되는 역할의 I/O 리소스 목록 개체입니다. 이 개체는 프레임워크에서 할당되고 프레임워크가 드라이버의 EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS 구현을 호출할 때 클라이언트 드라이버에 전달됩니다.
[in] Descriptor
역할에 대한 리소스 설명자를 포함하는 IO_RESOURCE_DESCRIPTOR 대한 포인터입니다.
반환 값
메서드는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드가 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.
설명
클라이언트 드라이버가 UrsDeviceInitialize를 호출한 후 프레임워크는 리소스 요구 사항 목록에 대한 메모리를 할당합니다. USB 이중 역할 클래스 확장이 클라이언트 드라이버의 EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS 구현을 호출하면 호스트 및 함수 역할 리소스 목록에 대한 URSIORESLIST 핸들과 함께 WDFIORESREQLIST 핸들을 해당 요구 사항 목록에 전달합니다. 구현에서 클라이언트 드라이버는 요구 사항 목록을 열거하고 리소스 설명자(해당 리소스를 사용하려는 경우)를 각 역할의 리소스 목록에 추가해야 합니다.
역할에 대한 리소스 설명자를 추가하기 위해 드라이버는 UrsIoResourceListAppendDescriptor 를 호출하고 리소스를 추가해야 하는 설명자 및 리소스 목록을 지정합니다.
코드 예제는 EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS 참조하세요.
리소스 요구 사항 목록에 대한 자세한 내용은 하드웨어 리소스 처리를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 |
| 지원되는 최소 서버 | Windows Server 2016 |
| 대상 플랫폼 | Windows |
| 최소 KMDF 버전 | 1.15 |
| 머리글 | ursdevice.h(Urscx.h 포함) |
| 라이브러리 | Urscxstub.lib |
| IRQL | PASSIVE_LEVEL |