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

Artículo
08/07/2023

El NewStream método crea una nueva instancia de un objeto de secuencia WaveRT.

Sintaxis

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

Parámetros

[out] Stream

Puntero de salida para la nueva secuencia. Este parámetro apunta a una variable de puntero asignada por el autor de la llamada, en la que el NewStream método escribe un puntero en la interfaz IMiniportWaveRTStream del nuevo objeto de secuencia. El autor de la llamada especifica un puntero válido que no es NULL para este parámetro.

[in] PortStream

Puntero a IPortWaveRTStream.

[in] Pin

Especifica un identificador de patilla que identifica la patilla que se va a abrir. Si el descriptor de filtro del controlador de miniporte waveRT especifica un total de n generadores de patillas en el filtro, los valores válidos para el parámetro Pin están en el intervalo de 0 a n-1. Para obtener más información sobre los descriptores de filtro, consulte el tema Factorías de filtros.

[in] Capture

Especifica un valor booleano que indica si se va a crear una secuencia de captura o una secuencia de representación. Este parámetro es TRUE para una secuencia de captura (entrada) y FALSE para una secuencia de reproducción (salida).

[in] DataFormat

Puntero a una estructura KSDATAFORMAT que especifica el formato de datos de la nueva secuencia. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

NewStream devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de estado de error adecuado.

Comentarios

El NewStream método establece el estado inicial de la secuencia en KSSTATE_STOP y su posición inicial en 0. Para obtener más información, vea los métodos relacionados IMiniportWaveRTStream::SetState e IMiniportWaveRTStream::GetPosition.

El parámetro DataFormat , que especifica el formato de datos de la secuencia, apunta a una de las siguientes versiones extendidas específicas de audio de la estructura KSDATAFORMAT:

Los parámetros Stream y PortStream siguen las convenciones de recuento de referencias para objetos COM.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y en sistemas operativos Windows posteriores.
Plataforma de destino	Universal
Encabezado	portcls.h
IRQL	Nivel pasivo.