Bagikan melalui

Sematkan Kumpulan 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 menentukan kategori pin berikut dalam file header Uuids.h.

GUID Kategori Deskripsi
PIN_CATEGORY_ANALOGVIDEOIN Pin input filter pengambilan yang mengambil analog dan mendigitalkannya.
PIN_CATEGORY_CAPTURE Tangkap pin.
PIN_CATEGORY_CC Sematkan menyediakan data keterangan tertutup dari Baris 21.
PIN_CATEGORY_EDS Sematkan yang menyediakan Extended Data Services (Baris 21, bahkan bidang).
PIN_CATEGORY_NABTS Sematkan yang menyediakan data North American Videotext Standard.
PIN_CATEGORY_PREVIEW Pin pratinjau.
PIN_CATEGORY_STILL Sematkan yang menyediakan gambar diam. Pin pengambilan filter harus disambungkan sebelum pin gambar diam tersambung.
PIN_CATEGORY_TELETEXT Sematkan yang menyediakan teleteks (varian keterangan tertutup).
PIN_CATEGORY_TIMECODE Sematkan penyediaan data kode waktu.
PIN_CATEGORY_VBI Sematkan menyediakan data interval pengosongan vertikal.
PIN_CATEGORY_VIDEOPORT Pin output video yang akan disambungkan ke pin input nol pada Overlay Mixer.
PIN_CATEGORY_VIDEOPORT_VBI Sematkan untuk terhubung ke VBI Surface Allocator, 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 digunakan. Skenario PCI, IEEE 1394, dan USB tidak menggunakan filter ini.
PINNAME_VIDEO_CC_CAPTURE Pin pemotongan teks tertutup perangkat keras

 

Properti ini bersifat baca-saja.

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;
}

Nota

Contoh ini menggunakan fungsi SafeRelease untuk merilis pointer antarmuka.

 

Persyaratan Pin untuk Filter Pengambilan

Set Properti

Bekerja dengan Kategori Pin