Anheften von Eigenschaftensatz

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Der Pin-Eigenschaftssatz gibt die Pinkategorie für eine Pin in einem Filter zurück. Die Kategorie wird vom Filter festgelegt, wenn er den Pin erstellt. die Kategorie gibt an, welche Art von Daten der Pin übermittelt oder empfangen wird.

Bezeichnung Wert
Eigenschaftensatz-GUID AMPROPSETID_Pin

 

Eigenschafts-ID BESCHREIBUNG
AMPROPERTY_PIN_CATEGORY Gibt die Kategorie eines Pins an.

 

DirectShow definiert die folgenden Pinkategorien in der Headerdatei "Uuids.h".

Kategorie-GUID BESCHREIBUNG
PIN_CATEGORY_ANALOGVIDEOIN Eingabenadel des Erfassungsfilters, der analog annimmt und digitalisiert.
PIN_CATEGORY_CAPTURE Aufnahmenadel.
PIN_CATEGORY_CC Anheften von Untertiteldaten aus Zeile 21.
PIN_CATEGORY_EDS Anheften von erweiterten Datendiensten (Zeile 21, gerade Felder).
PIN_CATEGORY_NABTS Anheften von North American Videotext Standard-Daten.
PIN_CATEGORY_PREVIEW Vorschaunadel.
PIN_CATEGORY_STILL Anheften, das ein Standbild bereitstellt. Der Erfassungspin des Filters muss verbunden sein, bevor der Standbild-Pin verbunden wird.
PIN_CATEGORY_TELETEXT Anheften von Teletext (eine Variante mit Untertiteln).
PIN_CATEGORY_TIMECODE Anheften von Timecodedaten.
PIN_CATEGORY_VBI Anheften, um vertikale Leerungsintervalldaten bereitzustellen.
PIN_CATEGORY_VIDEOPORT Videoausgabepin, der an den Eingabenadel 0 des Überlagerungsmischers angeschlossen werden soll.
PIN_CATEGORY_VIDEOPORT_VBI Anheften, um mit dem VBI Surface Allocator verbunden zu werden, dem VBI-Oberflächenverteilerfilter, der benötigt wird, um den richtigen Videospeicher für Dinge wie Untertitelüberlagerungen in Szenarien zuzuweisen, in denen ein Videoport verwendet wird. PCI-, IEEE 1394- und USB-Szenarien verwenden diesen Filter nicht.
PINNAME_VIDEO_CC_CAPTURE Hardware-Slicing-Pin für Untertitel

 

Diese Eigenschaft ist schreibgeschützt.

Beispielcode

Der folgende Code zeigt, wie Sie überprüfen, ob ein Pin diesen Eigenschaftssatz unterstützt, und wenn ja, wie Sie die Pinkategorie abrufen:

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

Hinweis

In diesem Beispiel wird die SafeRelease-Funktion verwendet, um Schnittstellenzeiger freizugeben.

 

Pinanforderungen für Erfassungsfilter

Eigenschaftensätze

Arbeiten mit Anheftkategorien