Compartilhar via


Função PcNewResourceSublist (portcls.h)

A função PcNewResourceSublist cria e inicializa uma lista de recursos vazia derivada de outra lista de recursos.

Sintaxe

PORTCLASSAPI NTSTATUS PcNewResourceSublist(
  [out]          PRESOURCELIST *OutResourceList,
  [in, optional] PUNKNOWN      OuterUnknown,
  [in]           POOL_TYPE     PoolType,
  [in]           PRESOURCELIST ParentList,
  [in]           ULONG         MaximumEntries
);

Parâmetros

[out] OutResourceList

Ponteiro de saída para o objeto de lista de recursos que essa função cria. Esse parâmetro aponta para a variável de ponteiro alocada pelo chamador na qual a função gera o ponteiro para o objeto IResourceList . Especifique um valor de ponteiro válido e não NULL para esse parâmetro.

[in, optional] OuterUnknown

Ponteiro para a interface IUnknown de um objeto que precisa agregar o objeto. A menos que a agregação seja necessária, defina esse parâmetro como NULL.

[in] PoolType

Especifica o tipo de pool do qual o objeto deve ser alocado. Esse é um valor de enumeração POOL_TYPE .

[in] ParentList

Ponteiro para a lista de recursos da qual a lista filho será criada. A lista de recursos tem uma interface IResourceList .

[in] MaximumEntries

Especifica o número máximo de entradas que serão adicionadas à lista de recursos.

Retornar valor

PcNewResourceSublist retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.

Comentários

Essa função cria uma sublist de recursos vazia.

Um driver de adaptador normalmente usa a função PcNewResourceSublist em combinação com o método IResourceList::AddEntryFromParent para pegar a lista original de recursos recebidos do sistema e dividi-los em sublistes que ele atribui a seus vários subdispositivos.

Os parâmetros OutResourceList, OuterUnknown e ParentList seguem as convenções de contagem de referência para objetos COM.

Requisitos

Requisito Valor
Cliente mínimo com suporte O driver do sistema PortCls implementa a função PcNewResourceSublist no Microsoft Windows 98/Me e nos sistemas operacionais Windows 2000 e posterior.
Plataforma de Destino Universal
Cabeçalho portcls.h (inclua Portcls.h)
Biblioteca Portcls.lib
IRQL PASSIVE_LEVEL

Confira também

IResourceList

IResourceList::AddEntryFromParent

POOL_TYPE