PIN_INFO-Struktur (strmif.h)

  • Artikel

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

Die PIN_INFO -Struktur enthält Informationen zu einer Stecknadel.

Syntax

typedef struct _PinInfo {
  IBaseFilter   *pFilter;
  PIN_DIRECTION dir;
  WCHAR         achName[128];
} PIN_INFO;

Member

pFilter

Zeiger auf die IBaseFilter-Schnittstelle des besitzenden Filters.

dir

Richtung des Pins (Eingabe oder Ausgabe).

achName[128]

Name des Pins.

Bemerkungen

Wenn der Name eines Ausgabepins mit einer Tilde (~) beginnt, ignoriert der Filterdiagramm-Manager den Pin beim Erstellen eines Graphen. Während eines Aufrufs von IGraphBuilder::Connect, IGraphBuilder::Render oder IGraphBuilder::RenderFile wird der Pin nicht vom Filter gerendert, wenn die Pin in einem Zwischenfilter angezeigt wird. Die Pin wird jedoch gerendert, wenn Sie den Pin explizit an die Connect- oder Render-Methode übergeben.

Verwenden Sie eine Tilde, wenn der Pin einen sekundären Datenstrom übermittelt, der standardmäßig nicht gerendert werden soll, oder wenn für die Pin ein spezieller Code zum ordnungsgemäßen Rendern erforderlich ist. Dvd-Filter sollten sie beispielsweise für Pins verwenden, die Subpicture- oder Untertiteldaten liefern. Videoaufnahmefilter sollten sie für Aufnahmepins (aber keine Vorschaupins) verwenden.

Der pFilter-Member verfügt über eine ausstehende Verweisanzahl. Die Anwendung muss die Schnittstelle freigeben.

Requirements (Anforderungen)

   
Kopfzeile strmif.h (include Dshow.h)

Siehe auch

DirectShow-Strukturen

IPin::QueryPinInfo