Freigeben über

Pin-Eigenschaftssatz

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow-ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngineund Audio/Video Capture in Media Foundationersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code MediaPlayer-, IMFMediaEngine und Audio-/Videoaufnahme in Media Foundation anstelle von DirectShow-verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, um die neuen APIs zu verwenden, falls möglich umgeschrieben werden.]

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

Etikett 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 Aufnahmefilters, der analog verwendet und digitalisieret.
PIN_CATEGORY_CAPTURE Aufnahmenadel.
PIN_CATEGORY_CC Anheften, um Untertiteldaten aus Zeile 21 bereitzustellen.
PIN_CATEGORY_EDS Pin für erweiterte Datendienste (Zeile 21, gerade Felder).
PIN_CATEGORY_NABTS Pin, die North American Videotext Standard-Daten bereitstellt.
PIN_CATEGORY_PREVIEW Vorschau-Pin.
PIN_CATEGORY_STILL Anheften, das ein stilles Bild bereitstellt. Der Aufnahmenadel des Filters muss verbunden werden, bevor der Pin für das Stillbild verbunden ist.
PIN_CATEGORY_TELETEXT Anheften von Teletext (eine Untertitelvariante).
PIN_CATEGORY_TIMECODE Stellen Sie Zeitcodedaten bereit.
PIN_CATEGORY_VBI Anheften, um vertikale Leerzeichenintervalldaten bereitzustellen.
PIN_CATEGORY_VIDEOPORT Videoausgabe-Pin, der mit eingabenadel null im Overlay Mixerverbunden werden soll.
PIN_CATEGORY_VIDEOPORT_VBI Pin to be connected to be connected to the VBI Surface Allocator, the VBI surface allocator filter that is needed to allocate the correct video memory for things like closed captioning overlays in scenarios where a video port is used. 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 eine Pin diesen Eigenschaftensatz 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;
}

Anmerkung

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

 

Pinanforderungen für Aufnahmefilter

-Eigenschaftensätze

Arbeiten mit Pinkategorien