METODE IMFASFStreamConfig::GetPayloadExtension (wmcontainer.h)

Artikel
03/13/2024

Mengambil informasi tentang ekstensi payload yang ada.

Sintaks

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

Parameter

[in] wPayloadExtensionNumber

Indeks ekstensi payload. Indeks yang valid berkisar dari 0, hingga satu kurang dari jumlah ekstensi yang diperoleh dengan memanggil IMFASFStreamConfig::GetPayloadExtensionCount.

[out] pguidExtensionSystemID

Menerima GUID yang mengidentifikasi ekstensi payload. Untuk daftar ekstensi payload yang telah ditentukan sebelumnya, lihat GUID Ekstensi Payload ASF. Aplikasi juga dapat menentukan ekstensi payload kustom.

[out] pcbExtensionDataSize

Menerima jumlah byte yang ditambahkan ke setiap sampel untuk ekstensi.

[out] pbExtensionSystemInfo

Penunjuk ke buffer yang menerima informasi tentang sistem ekstensi ini. Informasi ini sama untuk semua sampel dan disimpan di header konten (bukan di setiap sampel). Parameter ini bisa NULL. Untuk menemukan ukuran buffer yang diperlukan, atur parameter ini ke NULL; ukuran dikembalikan dalam pcbExtensionSystemInfo.

[in, out] pcbExtensionSystemInfo

Pada input, menentukan ukuran buffer yang diacu oleh pbExtensionSystemInfo. Pada output, menerima ukuran buffer pbExtensionSystemInfo yang diperlukan dalam byte.

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Argumen tidak valid.
MF_E_BUFFERTOOSMALL	Buffer yang ditentukan dalam pbExtensionSystemInfo terlalu kecil.
MF_E_INVALIDINDEX	Parameter wPayloadExtensionNumber berada di luar rentang.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wmcontainer.h
Pustaka	Mfuuid.lib

Lihat juga

IMFASFStreamConfig

IMFASFStreamConfig::AddPayloadExtension

IMFASFStreamConfig::GetPayloadExtensionCount

Bagikan melalui