Método IMiniportWaveRT::NewStream (portcls.h)
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. |
Consulte también
IMiniportWaveRTStream
IMiniportWaveRTStream::GetPosition