Método IMiniportMidi::NewStream (portcls.h)
El NewStream
método 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 autor de la llamada en la que el método escribe un puntero en la interfaz IMiniportMidiStream del objeto de secuencia.
[in, optional] OuterUnknown
Puntero a la 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 POOL_TYPE valores de enumeración.
[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 patilla válidos se encuentran 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 es TRUE, es un canal de captura (entrada). Si es FALSE, es un canal de reproducción (salida).
[in] DataFormat
Puntero a una estructura 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 autor de la llamada 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.
Comentarios
El NewStream
método establece el estado inicial de la secuencia en KSSTATE_STOP.
Los parámetros Stream, OuterUnknown y ServiceGroup siguen las convenciones de recuento de referencias para objetos COM.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Universal |
Encabezado | portcls.h (incluir Portcls.h) |
IRQL | PASSIVE_LEVEL |