Metodo IMFASFProfile::GetStream (wmcontainer.h)

Articolo
03/13/2024

Recupera un flusso dal profilo in base all'indice del flusso e/o recupera il numero di flusso per un indice di flusso.

Sintassi

HRESULT GetStream(
  [in]  DWORD              dwStreamIndex,
  [out] WORD               *pwStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

Parametri

[in] dwStreamIndex

Indice del flusso da recuperare. Stream indici sono sequenziali e in base zero. È possibile ottenere il numero di flussi presenti nel profilo chiamando il metodo IMFASFProfile::GetStreamCount .

[out] pwStreamNumber

Riceve il numero di flusso del flusso richiesto. Stream numeri sono basati su un solo e non sono necessariamente sequenziali. Questo parametro può essere impostato su NULL se il numero di flusso non è obbligatorio.

[out] ppIStream

Riceve un puntatore all'interfaccia IMFASFStreamConfig dell'oggetto di configurazione del flusso ASF. Il chiamante deve rilasciare l'interfaccia. Questo parametro può essere NULL se si desidera recuperare il numero di flusso senza accedere alla configurazione del flusso.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

Questo metodo non crea una copia dell'oggetto di configurazione del flusso. Puntatore recuperato punta all'oggetto all'interno dell'oggetto profilo. Non è necessario apportare modifiche all'oggetto di configurazione del flusso usando questo puntatore, perché questa operazione può influire sull'oggetto profilo in modi imprevisti.

Per modificare la configurazione dell'oggetto di configurazione del flusso nel profilo, è necessario prima clonare l'oggetto di configurazione del flusso chiamando IMFASFStreamConfig::Clone. Apportare le modifiche necessarie al clone dell'oggetto e quindi aggiungere l'oggetto aggiornato chiamando il metodo IMFASFProfile::SetStream .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wmcontainer.h
Libreria	Mfuuid.lib