Metode IMediaSeeking::GetCapabilities (strmif.h)

Artikel
03/02/2024

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 ini GetCapabilities mengambil semua kemampuan pencarian aliran.

Sintaks

HRESULT GetCapabilities(
  [out] DWORD *pCapabilities
);

Parameter

[out] pCapabilities

Penunjuk ke variabel yang menerima kombinasi bitwise dari bendera AM_SEEKING_SEEKING_CAPABILITIES .

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Argumen penunjuk NULL.

Keterangan

Metode ini mengembalikan informasi tentang semua kemampuan pencarian aliran. Periksa pCapabilities dengan melakukan operasi bitwise-AND terpisah pada setiap nilai AM_SEEKING_SEEKING_CAPABILITIES yang Anda minati.

C++
DWORD dwCaps = 0; pMediaSeeking-GetCapabilities>(&dwCaps); if (dwCaps & AM_SEEKING_CanGetCurrentPos) { // The stream can seek to the current position. } if (dwCaps & AM_SEEKING_CanPlayBackwards) { // The stream can play backward. }

C++

DWORD dwCaps = 0; pMediaSeeking-GetCapabilities>(&dwCaps);if (dwCaps & AM_SEEKING_CanGetCurrentPos)
{
// The stream can seek to the current position.
}
if (dwCaps & AM_SEEKING_CanPlayBackwards)
{
// The stream can play backward.
}

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

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IMediaSeeking

Bagikan melalui