Função PcNewResourceList (portcls.h)

Artigo
02/07/2025

A função PcNewResourceList cria e inicializa uma lista de recursos.

Sintaxe

PORTCLASSAPI NTSTATUS PcNewResourceList(
  [out]          PRESOURCELIST     *OutResourceList,
  [in, optional] PUNKNOWN          OuterUnknown,
  [in]           POOL_TYPE         PoolType,
  [in]           PCM_RESOURCE_LIST TranslatedResources,
  [in]           PCM_RESOURCE_LIST UntranslatedResources
);

Parâmetros

[out] OutResourceList

Ponteiro de saída para o objeto de lista de recursos criado por essa função. Esse parâmetro aponta para uma variável de ponteiro alocada por 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 de lista de recursos. 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] TranslatedResources

Ponteiro para uma lista de recursos fornecida pelo WDM para recursos traduzidos. A lista é uma estrutura do sistema do tipo CM_RESOURCE_LIST.

[in] UntranslatedResources

Ponteiro para uma lista de recursos fornecida pelo WDM para recursos não traduzidos. A lista é uma estrutura do sistema do tipo CM_RESOURCE_LIST.

Valor de retorno

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

Observações

Para obter uma discussão sobre listas de recursos traduzidas e não traduzidas (ou "brutas"), consulte Mapeamento Bus-Relative Endereços para Endereços Virtuais.

Os parâmetros OutResourceList e OuterUnknown 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 PcNewResourceList 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

Consulte também

CM_RESOURCE_LIST

IResourceList

POOL_TYPE

Compartilhar via