Metode IKsDataTypeCompletion::KsCompleteMediaType (ksproxy.h)

  • Artikel

Metode KsCompleteMediaType menyelesaikan jenis media yang ditentukan sebagian yang pertama kali disajikan ke metode IAMStreamConfig::SetFormat .

Sintaks

HRESULT KsCompleteMediaType(
  [in]      HANDLE        FilterHandle,
  [in]      ULONG         PinFactoryId,
  [in, out] AM_MEDIA_TYPE *AmMediaType
);

Parameter

[in] FilterHandle

Tangani ke filter KS yang mendasar.

[in] PinFactoryId

Pengidentifikasi pabrik pin tempat jenis media sedang diselesaikan.

[in, out] AmMediaType

Arahkan ke struktur AM_MEDIA_TYPE yang menjelaskan format sampel media. KsCompleteMediaType menerima sampel media yang ditentukan sebagian, menyelesaikan spesifikasi, dan mengembalikan.

Nilai kembali

Mengembalikan NOERROR jika berhasil dan jenis media selesai; jika tidak, mengembalikan kode kesalahan.

Keterangan

Metode KsCompleteMediaType terutama digunakan untuk jenis media video, di mana anggota biSizeImage dari struktur KS_BITMAPINFOHEADER hanya diketahui oleh driver, karena format kompresi privat yang didukung. Jika diperlukan, penangan jenis data dapat mengkueri filter KS yang mendasar untuk menyelesaikan jenis media yang diberikan.

Ketika proksi membuat instans penangan jenis data untuk tujuan menyelesaikan jenis media, proksi meneruskan jenis media ke metode IKsDataTypeHandler::KsSetMediaType untuk terlebih dahulu menginisialisasi penangan jenis data ini ke jenis media tertentu.

Untuk informasi selengkapnya tentang IAMStreamConfig::SetFormat dan AM_MEDIA_TYPE, lihat dokumentasi Microsoft Windows SDK.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header ksproxy.h (termasuk Ksproxy.h)

Lihat juga

IKsDataTypeHandler::KsSetMediaType

KS_BITMAPINFOHEADER