IAMStreamConfig::Metode GetFormat (strmif.h)
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]
Metode mengambil GetFormat
format output saat ini atau pilihan.
Sintaks
HRESULT GetFormat(
[out] AM_MEDIA_TYPE **ppmt
);
Parameter
[out] ppmt
Alamat penunjuk ke struktur AM_MEDIA_TYPE .
Mengembalikan nilai
Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Berhasil. |
|
Memori tidak cukup. |
|
Nilai pointer NULL. |
|
Pin input tidak tersambung. |
Keterangan
Jika pin tersambung, metode ini mengembalikan format yang saat ini digunakan pin. Jika tidak, metode mengembalikan format pilihan pin untuk koneksi pin berikutnya. Jika Anda telah memanggil metode IAMStreamConfig::SetFormat untuk mengatur format, GetFormat
mengembalikan format yang sama. Jika tidak, ini mengembalikan format pertama dalam daftar pin format pilihan, seperti yang ditentukan oleh metode IPin::EnumMediaTypes .
Metode ini mengalokasikan memori untuk struktur AM_MEDIA_TYPE , mengisi struktur, dan mengembalikannya dalam parameter pmt . Pemanggil harus melepaskan memori, termasuk blok format. Anda dapat menggunakan fungsi pembantu DeleteMediaType di pustaka kelas dasar.
Pada beberapa filter pemadatan, metode gagal jika pin input filter tidak tersambung.
Contoh
C++ |
---|
IAMStreamConfig *pConfig = NULL; // Query the output pin for IAMStreamConfig (not shown). AM_MEDIA_TYPE *pmt = NULL; hr = pConfig->GetFormat(&pmt); if (SUCCEEDED(hr)) { /* Examine the media type for any information you need. */ DeleteMediaType(pmt); } pConfig->Release(); |
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | strmif.h (termasuk Dshow.h) |
Pustaka | Strmiids.lib |