Metodo IMiniportWaveRT::NewStream (portcls.h)
Il NewStream
metodo crea una nuova istanza di un oggetto flusso WaveRT.
Sintassi
NTSTATUS NewStream(
[out] PMINIPORTWAVERTSTREAM *Stream,
[in] PPORTWAVERTSTREAM PortStream,
[in] ULONG Pin,
[in] BOOLEAN Capture,
[in] PKSDATAFORMAT DataFormat
);
Parametri
[out] Stream
Puntatore di output per il nuovo flusso. Questo parametro punta a una variabile puntatore allocata dal chiamante, in cui il NewStream
metodo scrive un puntatore nell'interfaccia IMiniportWaveRTStream del nuovo oggetto flusso. Il chiamante specifica un puntatore non NULL valido per questo parametro.
[in] PortStream
Puntatore a IPortWaveRTStream.
[in] Pin
Specifica un ID pin che identifica il pin da aprire. Se il descrittore di filtro del driver miniport WaveRT specifica un totale di n pin factory nel filtro, i valori validi per il parametro Pin sono compresi nell'intervallo da 0 a n-1. Per altre informazioni sui descrittori di filtro, vedere l'argomento Filter Factory .
[in] Capture
Specifica un valore booleano che indica se creare un flusso di acquisizione o un flusso di rendering. Questo parametro è TRUE per un flusso di acquisizione (input) e FALSE per un flusso di riproduzione (output).
[in] DataFormat
Puntatore a una struttura KSDATAFORMAT che specifica il formato di dati del nuovo flusso. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Valore restituito
NewStream
restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di stato di errore appropriato.
Commenti
Il NewStream
metodo imposta lo stato iniziale del flusso su KSSTATE_STOP e la relativa posizione iniziale su 0. Per altre informazioni, vedere i metodi correlati IMiniportWaveRTStream::SetState e IMiniportWaveRTStream::GetPosition.
Il parametro DataFormat , che specifica il formato di dati del flusso, punta a una delle versioni estese specifiche dell'audio seguenti della struttura KSDATAFORMAT:
I parametri Stream e PortStream seguono le convenzioni di conteggio dei riferimenti per gli oggetti COM.Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Windows Vista e nei sistemi operativi Windows successivi. |
Piattaforma di destinazione | Universale |
Intestazione | portcls.h |
IRQL | Livello passivo. |
Vedi anche
IMiniportWaveRTStream
IMiniportWaveRTStream::GetPosition