PcNewResourceSublist 함수(portcls.h)
PcNewResourceSublist 함수는 다른 리소스 목록에서 파생된 빈 리소스 목록을 만들고 초기화합니다.
구문
PORTCLASSAPI NTSTATUS PcNewResourceSublist(
[out] PRESOURCELIST *OutResourceList,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PRESOURCELIST ParentList,
[in] ULONG MaximumEntries
);
매개 변수
[out] OutResourceList
이 함수가 만드는 resource-list 개체에 대한 출력 포인터입니다. 이 매개 변수는 함수가 IResourceList 개체에 대한 포인터를 출력하는 호출자가 할당한 포인터 변수를 가리킵니다. 이 매개 변수에 유효한 NULL 이 아닌 포인터 값을 지정합니다.
[in, optional] OuterUnknown
개체를 집계해야 하는 개체의 IUnknown 인터페이스에 대한 포인터입니다. 집계가 필요하지 않은 경우 이 매개 변수를 NULL로 설정합니다.
[in] PoolType
개체를 할당할 풀의 형식을 지정합니다. POOL_TYPE 열거형 값입니다.
[in] ParentList
자식 목록을 만들 리소스 목록에 대한 포인터입니다. 리소스 목록에는 IResourceList 인터페이스가 있습니다.
[in] MaximumEntries
리소스 목록에 추가될 최대 항목 수를 지정합니다.
반환 값
PcNewResourceSublist 는 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.
설명
이 함수는 빈 리소스 하위 목록을 만듭니다.
어댑터 드라이버는 일반적으로 IResourceList::AddEntryFromParent 메서드와 함께 PcNewResourceSublist 함수를 사용하여 시스템에서 받은 리소스의 원래 목록을 가져와서 다양한 하위 서비스에 할당하는 하위 목록으로 나눕니다.
OutResourceList, OuterUnknown 및 ParentList 매개 변수는 COM 개체에 대한 참조 계산 규칙을 따릅니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | PortCls 시스템 드라이버는 Microsoft Windows 98/Me 및 Windows 2000 이상 운영 체제에서 PcNewResourceSublist 함수를 구현합니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | portcls.h(Portcls.h 포함) |
| 라이브러리 | Portcls.lib |
| IRQL | PASSIVE_LEVEL |