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 NULL nulo válido 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 para 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.
Valor de retorno
PcNewResourceSublist retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.
Observações
Essa função cria uma sublista de recursos vazia.
Um driver de adaptador normalmente usa a função PcNewResourceSublist em combinação com o método IResourceList::AddEntryFromParent para usar a lista original de recursos recebidos do sistema e dividi-los em sublinhos que ele atribui a seus vários subconjuntos.
Os parâmetros OutResourceList, OuterUnknowne ParentList seguem as convenções de contagem de referência para objetos COM.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | O driver do sistema PortCls implementa a função PcNewResourceSublist no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores. |
| da Plataforma de Destino | Universal |
| cabeçalho | portcls.h (inclua Portcls.h) |
| biblioteca | Portcls.lib |
| IRQL | PASSIVE_LEVEL |