Share via

IMFASFStreamConfig：：GetPayloadExtension 方法 (wmcontainer.h)

  • 發行項

擷取現有承載延伸模組的相關信息。

語法

HRESULT GetPayloadExtension(
  [in]      WORD  wPayloadExtensionNumber,
  [out]     GUID  *pguidExtensionSystemID,
  [out]     WORD  *pcbExtensionDataSize,
  [out]     BYTE  *pbExtensionSystemInfo,
  [in, out] DWORD *pcbExtensionSystemInfo
);

參數

[in] wPayloadExtensionNumber

承載延伸模組索引。 有效的索引範圍從 0 到呼叫 IMFASFStreamConfig：：GetPayloadExtensionCount 取得的延伸模塊數目。

[out] pguidExtensionSystemID

接收識別承載延伸模組的 GUID。 如需預先定義的承載延伸模組清單，請參閱 ASF 承載延伸模組 GUID。 應用程式也可以定義自定義承載延伸模組。

[out] pcbExtensionDataSize

接收新增至每個延伸模組範例的位元元組數目。

[out] pbExtensionSystemInfo

接收此擴充系統相關信息之緩衝區的指標。 此資訊適用於所有範例，而且會儲存在內容標頭中， (不在每個範例) 中。 此參數可以是 Null。 若要尋找所需的緩衝區大小，請將此參數設定為 NULL;大小會以 如下所示的方式傳回。

[in, out] pcbExtensionSystemInfo

在輸入時，指定 pbExtensionSystemInfo 所指向的緩衝區大小。 輸出時，會以位元組為單位接收 pbExtensionSystemInfo 緩衝區的必要大小。

傳回值

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

傳回碼 描述
S_OK
 此方法已成功。
E_INVALIDARG
 無效引數。
MF_E_BUFFERTOOSMALL
 pbExtensionSystemInfo 中指定的緩衝區太小。
MF_E_INVALIDINDEX
 wPayloadExtensionNumber 參數超出範圍。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wmcontainer.h
程式庫 Mfuuid.lib

另請參閱

IMFASFStreamConfig

IMFASFStreamConfig：：AddPayloadExtension

IMFASFStreamConfig：：GetPayloadExtensionCount