struktur AM_SAMPLE2_PROPERTIES (strmif.h)

Artikel
03/02/2024

[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.]

Struktur AM_SAMPLE2_PROPERTIES menjelaskan properti sampel media. Antarmuka IMediaSample2 menggunakan struktur ini.

Sintaks

typedef struct tagAM_SAMPLE2_PROPERTIES {
  DWORD          cbData;
  DWORD          dwTypeSpecificFlags;
  DWORD          dwSampleFlags;
  LONG           lActual;
  REFERENCE_TIME tStart;
  REFERENCE_TIME tStop;
  DWORD          dwStreamId;
  AM_MEDIA_TYPE  *pMediaType;
  BYTE           *pbBuffer;
  LONG           cbBuffer;
} AM_SAMPLE2_PROPERTIES;

Anggota

cbData

Panjang data properti, dalam byte. Anggota struktur ini untuk ekstensibilitas.

dwTypeSpecificFlags

Bendera khusus jenis. Bendera ditentukan secara terpisah untuk setiap jenis media. Nilai defaultnya adalah AM_VIDEO_FLAG_INTERLEAVED_FRAME (nol). Bendera berikut digunakan untuk streaming video. Mereka didefinisikan dalam file header dvdmedia.h.

Bendera	Makna
AM_VIDEO_FLAG_FIELD_MASK 0x0003	Gunakan masker ini untuk memeriksa apakah sampel adalah bidang atau bingkai.
AM_VIDEO_FLAG_INTERLEAVED_FRAME 0x0000	Sampelnya adalah bingkai. (Gunakan bitmask AM_VIDEO_FLAG_FIELD_MASK untuk menguji nilai ini.)
AM_VIDEO_FLAG_FIELD1 0x0001	Sampelnya adalah bidang 1. (Gunakan bitmask AM_VIDEO_FLAG_FIELD_MASK untuk menguji nilai ini.)
AM_VIDEO_FLAG_FIELD2 0x0002	Sampel adalah bidang 2. (Gunakan bitmask AM_VIDEO_FLAG_FIELD_MASK untuk menguji nilai ini.)
AM_VIDEO_FLAG_FIELD1FIRST 0x0004	Jika bendera ini diatur, tampilkan bidang 1 terlebih dahulu. Jika tidak, tampilkan bidang 2 terlebih dahulu. (Hanya berlaku ketika ada dua bidang per sampel.)
AM_VIDEO_FLAG_WEAVE 0x0008	Jika bendera ini diatur, gunakan mode weave (yaitu, jangan deinterlace sampel). Jika tidak, gunakan mode bob. Bendera ini hanya berlaku ketika ada dua bidang per sampel.
AM_VIDEO_FLAG_REPEAT_FIELD 0x0040	Jika bendera ini diatur, tampilkan bidang pertama lagi setelah menampilkan bidang kedua. (Hanya berlaku ketika ada dua bidang per sampel.)
AM_ReverseBlockStart 0x2	Menandakan dimulainya VOBU selama pemutaran terbalik video DVD. Untuk informasi selengkapnya, lihat Penyempurnaan Pemutaran DVD di Windows Vista.
AM_ReverseBlockEnd 0x4	Menandakan akhir VOBU selama pemutaran terbalik video DVD. Dvd Navigator mengatur bendera ini pada sampel kosong untuk memberi sinyal akhir VOBU. Untuk informasi selengkapnya, lihat Penyempurnaan Pemutaran DVD di Windows Vista.
AM_UseNewCSSKey 0x1	Untuk pemutaran DVD, menunjukkan titik dalam aliran ketika dekoder harus menerapkan kunci Content Scramble System (CSS) baru. Navigator DVD mengatur bendera ini pada sampel media kosong tepat sebelum menegosiasikan ulang kunci judul CSS. Sebelumnya, DVD Navigator salah mengirim kunci ini sebelum menegosiasikan kunci disk. Mulai windows 7, jika properti AM_PROPERTY_DVDCOPY_SUPPORTS_NEW_KEYCOUNT dekoder mengembalikan TRUE, DVD Navigator tidak mengirim bendera ini sebelum menegosiasikan kunci disk. Lihat Kumpulan Properti Perlindungan Salin DVD.

Bendera lain didefinisikan tetapi saat ini tidak digunakan. Lihat dvdmedia.h.

dwSampleFlags

Kombinasi bitwise dari bendera jenis data yang AM_SAMPLE_PROPERTY_FLAGS dijumlahkan. Bit yang tidak terdefinisi dicadangkan dan harus nol.

lActual

Panjang data yang valid dalam buffer.

tStart

Waktu mulai, jika valid. Anggota dwSampleFlags menentukan apakah anggota ini valid.

tStop

Hentikan waktu, jika valid. Anggota dwSampleFlags menentukan apakah anggota ini valid.

dwStreamId

Stream pengidentifikasi. Jika nilainya AM_STREAM_MEDIA, aliran berisi data media. Jika nilainya AM_STREAM_CONTROL, aliran berisi informasi kontrol. Aplikasi dapat menentukan nilai 0x80000000 atau lebih besar untuk penggunaannya sendiri. (Lihat AM_SAMPLE_PROPERTY_FLAGS.)

pMediaType

Penunjuk ke struktur AM_MEDIA_TYPE yang menentukan jenis media jika format telah berubah. Jika format ini tidak berubah, anggota ini ADALAH NULL.

pbBuffer

Arahkan ke buffer sampel.

cbBuffer

Ukuran buffer sampel, dalam byte.

Persyaratan

Persyaratan	Nilai
Header	strmif.h (termasuk Dshow.h)

Lihat juga

Struktur DirectShow

Bagikan melalui