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 개체에 대한 참조 계산 규칙을 따릅니다.

요구 사항

추가 정보

IResourceList

IResourceList::AddEntryFromParent

POOL_TYPE