Função PcAddStreamResource (portcls.h)

PcAddStreamResource adiciona um recurso de fluxo. Há suporte para dois tipos de recursos de fluxo: interrupções e threads de propriedade do driver. PcAddStreamResource pode ser chamado por qualquer driver de miniporto WaveRT não áudio que tenha interrupções/threads associados a um fluxo de áudio. Ele também pode ser chamado por drivers de miniporto WaveRT de áudio.

Sintaxe

PORTCLASSAPI NTSTATUS PcAddStreamResource(
  [in]  PDEVICE_OBJECT               PhysicalDeviceObject,
  [in]  PVOID                        ResourceSet,
  [in]  PPCSTREAMRESOURCE_DESCRIPTOR ResourceDescriptor,
  [out] PCSTREAMRESOURCE             *ResourceHandle
);

Parâmetros

[in] PhysicalDeviceObject

PDEVICE_OBJECT – o PDO da pilha de dispositivos usando esse recurso.

[in] ResourceSet

PVOID – reservado para uso futuro, definido como NULL. Somente recursos no escopo do dispositivo têm suporte no momento.

[in] ResourceDescriptor

PPCSTREAMRESOURCE_DESCRIPTOR – o recurso a ser adicionado. Para obter mais informações, consulte PCSTREAMRESOURCE_DESCRIPTOR.

[out] ResourceHandle

PCSTREAMRESOURCE* – o local que manterá o identificador de recurso. Para obter mais informações, consulte PcRemoveStreamResource.

Retornar valor

STATUS_SUCCESS – o driver pôde registrar o recurso do PDO especificado.

STATUS_INVALID_PARAMETER – o driver retornará esse erro se encontrar qualquer outro parâmetro inválido, além dos casos específicos para outras instâncias de status de erro.

Códigos de status padrão adicionais podem ser retornados.

Comentários

Para ajudar a garantir a operação sem falhas, os drivers de áudio devem registrar seus recursos de streaming com portcls. Isso permite que o sistema operacional gerencie recursos para evitar interferência entre streaming de áudio e outros subsistemas.

Stream recursos são todos os recursos usados pelo driver de áudio para processar fluxos de áudio ou garantir o fluxo de dados de áudio.

Todos os drivers de áudio devem registrar seus recursos de fluxo com o driver de classe de áudio. O driver registra os seguintes tipos de recursos: interrupções, threads de propriedade do driver e dependências em recursos de outra pilha de áudio (exemplo: pilhas paralelas de driver de áudio). Consulte a definição de PCSTREAMRESOURCE_DESCRIPTOR para obter mais informações.

O driver de áudio deve verificar se o recurso é válido ao fazer essa chamada.

Os drivers de áudio executados apenas em Windows 10 podem usar PcAddStreamResource e PcRemoveStreamResource. Para drivers de miniporto waveRT de áudio que também precisam ser executados em versões anteriores do Windows, use AddStreamResource e RemoveStreamResource.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Servidor mínimo com suporte	Windows Server 2016
Plataforma de Destino	Windows
Cabeçalho	portcls.h
Biblioteca	Portcls.lib
DLL	NA
IRQL	PASSIVE_LEVEL

Confira também

PCSTREAMRESOURCE_DESCRIPTOR

PcRemoveStreamResource