Metodo IMiniportWaveRT::NewStream (portcls.h)

Articolo
02/07/2025

Il metodo NewStream 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 metodo NewStream scrive un puntatore nell'interfaccia IMiniportWaveRTStream del nuovo oggetto flusso. Il chiamante specifica un puntatore nullvalido e non valido per questo parametro.

[in] PortStream

Puntatore al 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 altre informazioni, vedere la sezione Osservazioni seguente.

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.

Osservazioni

Il metodo NewStream imposta lo stato iniziale del flusso su KSSTATE_STOP e la relativa posizione iniziale su 0. Per altre informazioni, vedere metodi correlati IMiniportWaveRTStream::SetState e IMiniportWaveRTStream::GetPosition.

Il parametro DataFormat, che specifica il formato dei dati del flusso, punta a una delle versioni audio specifiche e estese seguenti della struttura KSDATAFORMAT:

I parametri Stream e PortStream seguono le convenzioni di conteggio dei riferimenti per gli oggetti COM.

Fabbisogno

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.

Vedere anche

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream::GetPosition

IMiniportWaveRTStream::SetState

IPortWaveRTStream

Condividi tramite