IMFASFProfile：：GetStream 方法 (wmcontainer.h)

依數據流索引從配置檔擷取數據流，以及/或擷取數據流索引的數據流編號。

語法

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

[in] dwStreamIndex

要擷取之數據流的索引。 Stream 索引是循序且以零起始的。您可以呼叫 IMFASFProfile：：GetStreamCount 方法，以取得配置檔中的數據流數目。

[out] pwStreamNumber

接收所要求數據流的數據流編號。 Stream 數位是以單一為基礎，不一定是循序的。如果不需要數據流編號，這個參數可以設定為 NULL 。

[out] ppIStream

接收 ASF 數據流組態物件的 IMFASFStreamConfig 介面指標。呼叫端必須釋放介面。如果您想要擷取數據流編號而不存取數據流組態，此參數可以是 NULL 。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。

這個方法不會建立數據流組態對象的複本。擷取的指標指向配置檔物件內的物件。您無法使用此指針對數據流組態對象進行任何變更，因為這麼做可能會以非預期的方式影響配置檔物件。

若要變更配置檔中數據流組態物件的組態，您必須先呼叫 IMFASFStreamConfig：：Clone 來複製數據流組態物件。呼叫 IMFASFProfile：：SetStream 方法，對對象的複製品進行任何變更，然後新增更新的物件。