METODE IMFByteStream::GetCapabilities (mfobjects.h)

Mengambil karakteristik aliran byte.

Sintaks

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

Parameter

[out] pdwCapabilities

Menerima bendera bitwise ATAU nol atau lebih. Bendera berikut ditentukan.

Nilai Makna
MFBYTESTREAM_IS_READABLE
0x00000001
Aliran byte dapat dibaca.
MFBYTESTREAM_IS_WRITABLE
0x00000002
Aliran byte dapat ditulis.
MFBYTESTREAM_IS_SEEKABLE
0x00000004
Aliran byte dapat dicari.
MFBYTESTREAM_IS_REMOTE
0x00000008
Aliran byte berasal dari sumber jarak jauh, seperti jaringan.
MFBYTESTREAM_IS_DIRECTORY
0x00000080
Aliran byte mewakili direktori file.
MFBYTESTREAM_HAS_SLOW_SEEK
0x00000100
Mencari di dalam aliran ini mungkin lambat. Misalnya, aliran byte mungkin diunduh dari jaringan.
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED
0x00000200
Aliran byte saat ini mengunduh data ke cache lokal. Operasi baca pada aliran byte mungkin memakan waktu lebih lama sampai data benar-benar diunduh.

Bendera ini dibersihkan setelah semua data diunduh.

Jika bendera MFBYTESTREAM_HAS_SLOW_SEEK juga diatur, itu berarti aliran byte harus mengunduh seluruh file secara berurutan. Jika tidak, aliran byte dapat merespons permintaan pencarian dengan memulai ulang unduhan dari titik baru di aliran.

MFBYTESTREAM_SHARE_WRITE
0x00000400
Utas atau proses lain dapat membuka aliran byte ini untuk menulis. Jika bendera ini ada, panjang aliran byte dapat berubah saat sedang dibaca.

Bendera ini dapat memengaruhi perilaku penangan byte-stream. Untuk informasi selengkapnya, lihat MF_BYTESTREAMHANDLER_ACCEPTS_SHARE_WRITE.

Catatan Memerlukan Windows 7 atau yang lebih baru.
 
MFBYTESTREAM_DOES_NOT_USE_NETWORK
0x00000800
Aliran byte saat ini tidak menggunakan jaringan untuk menerima konten. Perangkat keras jaringan mungkin memasuki status penghematan daya ketika bit ini diatur.
Catatan Membutuhkan Windows 8 atau yang lebih baru.
 

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Antarmuka ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

  • Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
  • Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header mfobjects.h (termasuk Mfidl.h)
Pustaka Mfuuid.lib

Lihat juga

IMFByteStream