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

Artigo
02/29/2024

O NewStream método 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 pelo chamador, na qual o NewStream método grava um ponteiro na interface IMiniportWaveRTStream do novo objeto de fluxo. O chamador especifica um ponteiro não NULL válido para esse parâmetro.

[in] PortStream

Ponteiro para 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 fábricas de pinos 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 Fábricas de Filtros .

[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.

Retornar valor

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

Comentários

O NewStream método 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
Cliente mínimo com suporte	Disponível no Windows Vista e em sistemas operacionais Windows posteriores.
Plataforma de Destino	Universal
Cabeçalho	portcls.h
IRQL	Nível passivo.