Udostępnij za pośrednictwem


Przypinanie zestawu właściwości

[Funkcja skojarzona z tą stroną, DirectShow, jest starszą funkcją. Został zastąpiony przez MediaPlayer, IMFMediaEnginei Audio/Video Capture w Media Foundation. Te funkcje zostały zoptymalizowane pod kątem systemów Windows 10 i Windows 11. Firma Microsoft zdecydowanie zaleca, aby nowy kod używał MediaPlayer, IMFMediaEngine i Audio/Video Capture w programie Media Foundation zamiast DirectShow, jeśli to możliwe. Firma Microsoft sugeruje, że istniejący kod, który używa starszych interfejsów API, należy przepisać go do korzystania z nowych interfejsów API, jeśli to możliwe.]

Zestaw właściwości pin zwraca kategorię pinezki dla numeru PIN filtru. Kategoria jest ustawiana przez filtr podczas tworzenia pinezki; kategoria wskazuje typ danych dostarczanych lub odbieranych przez ten numer PIN.

Etykieta Wartość
Identyfikator GUID zestawu właściwości AMPROPSETID_Pin

 

Identyfikator właściwości Opis
AMPROPERTY_PIN_CATEGORY Określa kategorię pinezki.

 

DirectShow definiuje następujące kategorie pinezki w pliku nagłówka Uuids.h.

Identyfikator GUID kategorii Opis
PIN_CATEGORY_ANALOGVIDEOIN Wejściowy numer PIN filtru przechwytywania, który przyjmuje go analogowo i cyfrowo.
PIN_CATEGORY_CAPTURE Przechwyć pinezkę.
PIN_CATEGORY_CC Przypnij podanie danych napisów z wiersza 21.
PIN_CATEGORY_EDS Przypnij dostarczanie rozszerzonych usług danych (wiersz 21, a nawet pola).
PIN_CATEGORY_NABTS Przypinanie danych w warstwie North American Videotext w warstwie Standardowa.
PIN_CATEGORY_PREVIEW Podgląd pinezki.
PIN_CATEGORY_STILL Przypnij, który udostępnia obraz nadal. Numer PIN przechwytywania filtru musi być połączony przed połączeniem numeru PIN obrazu.
PIN_CATEGORY_TELETEXT Przypinanie elementu teletekstowego (wariant napisów zamkniętych).
PIN_CATEGORY_TIMECODE Przypnij podanie danych kodu czasowego.
PIN_CATEGORY_VBI Przypnij, podając dane interwału odstępu pionowego.
PIN_CATEGORY_VIDEOPORT Wyprowadzenie wyjściowe wideo, które ma być podłączone do wejściowego kodu PIN zero na Nakładka Mikser.
PIN_CATEGORY_VIDEOPORT_VBI Przypnij, aby połączyć się z alokatora powierzchni VBI, filtr alokatora powierzchni VBI potrzebny do przydzielenia poprawnej pamięci wideo dla takich rzeczy, jak nakładki napisów w scenariuszach, w których jest używany port wideo. Scenariusze PCI, IEEE 1394 i USB nie używają tego filtru.
PINNAME_VIDEO_CC_CAPTURE Fragmentowanie sprzętu — kod PIN z napisami

 

Ta właściwość jest tylko do odczytu.

Przykładowy kod

Poniższy kod pokazuje, jak sprawdzić, czy numer PIN obsługuje ten zestaw właściwości, a jeśli tak, jak uzyskać kategorię pinezki:

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

Nuta

W tym przykładzie użyto funkcji SafeRelease w celu wydania wskaźników interfejsu.

 

wymagania dotyczące przypinania filtrów przechwytywania

zestawy właściwości

praca z kategoriami przypinania