Função PcNewResourceList (portcls.h)

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 resource-list criado por essa função. Esse parâmetro aponta para uma variável de ponteiro alocada pelo chamador na qual a função gera o ponteiro para o objeto IResourceList . Especifique um valor de ponteiro não NULL válido para esse parâmetro.

[in, optional] OuterUnknown

Ponteiro para a interface IUnknown de um objeto que precisa agregar o objeto resource-list. 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] TranslatedResources

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

[in] UntranslatedResources

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

Retornar valor

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

Comentários

Para obter uma discussão sobre listas de recursos traduzidos e não traduzidos (ou "brutos"), consulte Mapeando endereços 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
Cliente mínimo com suporte	O driver do sistema PortCls implementa a função PcNewResourceList no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores.
Plataforma de Destino	Universal
Cabeçalho	portcls.h (inclua Portcls.h)
Biblioteca	Portcls.lib
IRQL	PASSIVE_LEVEL

Confira também

CM_RESOURCE_LIST

IResourceList

POOL_TYPE