Método IMiniportMidi::NewStream (portcls.h)
El método NewStream crea una nueva instancia de una secuencia lógica asociada a un canal físico especificado.
Sintaxis
NTSTATUS NewStream(
[out] PMINIPORTMIDISTREAM *Stream,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] ULONG Pin,
[in] BOOLEAN Capture,
[in] PKSDATAFORMAT DataFormat,
[out] PSERVICEGROUP *ServiceGroup
);
Parámetros
[out] Stream
Puntero de salida para la nueva secuencia. Este parámetro apunta a una variable de puntero asignada por el llamador en la que el método escribe un puntero en la interfaz del objeto de secuencia IMiniportMidiStream.
[in, optional] OuterUnknown
Puntero al interfaz IUnknown de un objeto que necesita agregar el objeto de secuencia. Este parámetro es opcional. Si no se requiere la agregación, el autor de la llamada especifica este parámetro como NULL.
[in] PoolType
Especifica el tipo de grupo de memoria desde el que se debe asignar el almacenamiento para el objeto de canal DMA. Este parámetro se establece en uno de los valores de enumeración de POOL_TYPE.
[in] Pin
Especifica el identificador de patilla. Este parámetro identifica el pin que se va a abrir. Si el método IMiniport::GetDescription del objeto MIDI genera un descriptor de filtro que especifica un total de n generadores de patillas en el filtro, los identificadores de pin válidos están en el intervalo de 0 a n-1.
[in] Capture
Especifica si el canal se va a usar para la captura o para la reproducción. Si TRUE, es un canal de captura (entrada). Si FALSE, es un canal de reproducción (salida).
[in] DataFormat
Puntero a una estructura de KSDATAFORMAT que especifica el formato de datos que se va a usar para esta instancia de flujo.
[out] ServiceGroup
Puntero de salida para el grupo de servicios. Este parámetro apunta a una variable de puntero asignada por el llamador en la que el método escribe un puntero en la interfaz IServiceGroup del objeto de grupo de servicios de la secuencia. Este es el grupo de servicios que se está registrando para la notificación de interrupción.
Valor devuelto
NewStream devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.
Observaciones
El método NewStream establece el estado inicial de la secuencia en KSSTATE_STOP.
Los parámetros de Stream, OuterUnknowny ServiceGroup siguen las convenciones de recuento de referencias de para objetos COM.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | portcls.h (incluya Portcls.h) |
| irQL | PASSIVE_LEVEL |