Método IMiniportWaveRT::NewStream (portcls.h)
El método NewStream
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 método NewStream
escribe un puntero en la interfaz IMiniportWaveRTStream del nuevo objeto de secuencia. El autor de la llamada especifica un puntero deNULL válido que no es NULL para este parámetro.
[in] PortStream
Puntero al 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 de 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 de.
[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 de KSDATAFORMAT que especifica el formato de datos de la nueva secuencia. Para obtener más información, vea la siguiente sección Comentarios.
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.
Observaciones
El método NewStream
establece el estado inicial de la secuencia en KSSTATE_STOP y su posición inicial en 0. Para obtener más información, vea métodos relacionados IMiniportWaveRTStream::SetState y 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 | Valor |
---|---|
cliente mínimo admitido | Disponible en Windows Vista y sistemas operativos Windows posteriores. |
de la plataforma de destino de | Universal |
encabezado de | portcls.h |
irQL | Nivel pasivo. |
Consulte también
IMiniportWaveRTStream
IMiniportWaveRTStream::GetPosition