Condividi tramite


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

IMiniportWaveRT

IMiniportWaveRTStream

IMiniportWaveRTStream::GetPosition

IMiniportWaveRTStream::SetState

IPortWaveRTStream