IFileSinkFilter::GetCurFile method (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 GetCurFile nama dan jenis media file saat ini.
Sintaks
HRESULT GetCurFile(
[out] LPOLESTR *ppszFileName,
[out] AM_MEDIA_TYPE *pmt
);
Parameter
[out] ppszFileName
Alamat pointer yang menerima nama file, sebagai jenis OLESTR .
[out] pmt
Penunjuk ke struktur AM_MEDIA_TYPE yang menerima jenis media. Parameter ini dapat dengan NULL, dalam hal ini metode tidak mengembalikan jenis media.
Mengembalikan nilai
Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Berhasil. |
|
Tidak ada file yang dibuka. |
|
Memori tidak cukup. |
|
Argumen pointer NULL di ppszFileName. |
Keterangan
Jika filter belum membuka file, metode mungkin berhasil tetapi mengembalikan NULL dalam parameter ppszFileName . Periksa nilai saat metode kembali.
Metode mengalokasikan memori untuk string yang dikembalikan dalam ppszFileName, dan memori untuk blok format dalam jenis media (jika ada). Pemanggil harus membebaskan mereka dengan memanggil CoTaskMemFree. Untuk jenis media, Anda dapat menggunakan fungsi FreeMediaType di pustaka kelas dasar.
Persyaratan
| 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 |