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 |