Método IMiniportWaveRT::NewStream (portcls.h)

Artigo
02/07/2025

O método NewStream cria uma nova instância de um objeto de fluxo WaveRT.

Sintaxe

NTSTATUS NewStream(
  [out] PMINIPORTWAVERTSTREAM *Stream,
  [in]  PPORTWAVERTSTREAM     PortStream,
  [in]  ULONG                 Pin,
  [in]  BOOLEAN               Capture,
  [in]  PKSDATAFORMAT         DataFormat
);

Parâmetros

[out] Stream

Ponteiro de saída para o novo fluxo. Esse parâmetro aponta para uma variável de ponteiro alocada por chamador, na qual o método NewStream grava um ponteiro na interface IMiniportWaveRTStream do novo objeto de fluxo. O chamador especifica um ponteiro nulonulo válido e não para esse parâmetro.

[in] PortStream

Ponteiro para o IPortWaveRTStream.

[in] Pin

Especifica uma ID de pino que identifica o pino a ser aberto. Se o descritor de filtro do driver de miniporto WaveRT especificar um total de n fixar fábricas no filtro, os valores válidos para o parâmetro Pin estarão no intervalo de 0 a n-1. Para obter mais informações sobre descritores de filtro, consulte o tópico Filter Factories tópico.

[in] Capture

Especifica um valor booliano que indica se um fluxo de captura ou um fluxo de renderização deve ser criado. Esse parâmetro é TRUE para um fluxo de captura (entrada) e FALSE para um fluxo de reprodução (saída).

[in] DataFormat

Ponteiro para uma estrutura KSDATAFORMAT que especifica o formato de dados do novo fluxo. Para obter mais informações, consulte a seção Comentários a seguir.

Valor de retorno

NewStream retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retornará um código de status de erro apropriado.

Observações

O método NewStream define o estado inicial do fluxo como KSSTATE_STOP e sua posição inicial como 0. Para obter mais informações, consulte os métodos relacionados IMiniportWaveRTStream::SetState e IMiniportWaveRTStream::GetPosition.

O parâmetro DataFormat, que especifica o formato de dados do fluxo, aponta para uma das seguintes versões estendidas específicas de áudio da estrutura KSDATAFORMAT:

Os parâmetros Stream e PortStream seguem as convenções de contagem de referência para objetos COM.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e em sistemas operacionais Windows posteriores.
da Plataforma de Destino	Universal
cabeçalho	portcls.h
IRQL	Nível passivo.

Consulte também

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream::GetPosition

IMiniportWaveRTStream::SetState

IPortWaveRTStream

Partilhar via