Share via

Sematkan Set Properti

  • Artikel

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

Set properti pin mengembalikan kategori pin untuk pin pada filter. Kategori diatur oleh filter saat membuat pin; kategori menunjukkan jenis data apa yang dikirimkan atau diterima oleh pin ini.

Label Nilai
GUID Set Properti AMPROPSETID_Pin

 

ID Properti Deskripsi
AMPROPERTY_PIN_CATEGORY Menentukan kategori pin.

 

DirectShow mendefinisikan kategori pin berikut dalam file header Uuids.h.

GUID Kategori Deskripsi
PIN_CATEGORY_ANALOGVIDEOIN Pin input filter tangkapan yang mengambil analog dan mendigitalkannya.
PIN_CATEGORY_CAPTURE Tangkap pin.
PIN_CATEGORY_CC Sematkan menyediakan data teks tertutup dari Baris 21.
PIN_CATEGORY_EDS Pin menyediakan Extended Data Services (Baris 21, bahkan bidang).
PIN_CATEGORY_NABTS Pin menyediakan data Standar Videotext Amerika Utara.
PIN_CATEGORY_PREVIEW Pin pratinjau.
PIN_CATEGORY_STILL Sematkan yang menyediakan gambar diam. Pin tangkapan filter harus tersambung sebelum pin gambar diam tersambung.
PIN_CATEGORY_TELETEXT Sematkan menyediakan teleteks (varian keterangan tertutup).
PIN_CATEGORY_TIMECODE Menyematkan penyediaan data kode waktu.
PIN_CATEGORY_VBI Sematkan menyediakan data interval pengosongan vertikal.
PIN_CATEGORY_VIDEOPORT Pin output video untuk dihubungkan ke pin input nol pada Overlay Mixer.
PIN_CATEGORY_VIDEOPORT_VBI Sematkan untuk terhubung ke Alokator Permukaan VBI, filter alokator permukaan VBI yang diperlukan untuk mengalokasikan memori video yang benar untuk hal-hal seperti overlay keterangan tertutup dalam skenario di mana port video sedang digunakan. Skenario PCI, IEEE 1394, dan USB tidak menggunakan filter ini.
PINNAME_VIDEO_CC_CAPTURE Pin pemotongan teks tertutup perangkat keras

 

Properti ini bersifat hanya baca.

Contoh Kode

Kode berikut menunjukkan cara memeriksa apakah pin mendukung kumpulan properti ini, dan jika demikian, cara mendapatkan kategori pin:

HRESULT GetPinCategory(IPin *pPin, GUID *pPinCategory)
{
    IKsPropertySet *pKs = NULL;

    HRESULT hr = pPin->QueryInterface(IID_PPV_ARGS(&pKs));
    if (FAILED(hr))
    {
        return hr;
    }

    // Try to retrieve the pin category.
    DWORD cbReturned = 0;
    hr = pKs->Get(AMPROPSETID_Pin, AMPROPERTY_PIN_CATEGORY, NULL, 0, 
        pPinCategory, sizeof(GUID), &cbReturned);
    
    // If this succeeded, pPinCategory now contains the category GUID.

    SafeRelease(&pKs);
    return hr;
}

Catatan

Contoh ini menggunakan fungsi SafeRelease untuk merilis penunjuk antarmuka.

 

Persyaratan Pin untuk Filter Pengambilan

Set Properti

Bekerja dengan Kategori Pin