IPin::QueryInternalConnections-Methode (strmif.h)

[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 QueryInternalConnections-Methode ruft die Pins ab, die intern mit diesem Pin (innerhalb des Filters) verbunden sind.

Syntax

HRESULT QueryInternalConnections(
  [out]     IPin  **apPin,
  [in, out] ULONG *nPin
);

Parameter

[out] apPin

Adresse eines Arrays von IPin-Zeigern . Der Aufrufer ordnet das Array zu. Die -Methode füllt das Array mit IPin-Zeigern aus. Wenn nPin null ist, kann dieser Parameter NULL sein.

[in, out] nPin

Gibt bei der Eingabe die Größe des Arrays an. Gibt bei der Ausgabe die Anzahl der intern verbundenen Pins an.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Hinweise

Diese Methode gibt Informationen zur internen Zuordnung von Eingabestiften zu Ausgabepins des Filters zurück. Anders ausgedrückt: Es beschreibt, wie die Eingabepins Daten an die Ausgabepins übermitteln.

In den meisten Filtern stellt jeder Eingabestift eine Verbindung mit jedem Ausgabepin her. In einem Transformationsfilter wird beispielsweise eine Eingabe mit einer Ausgabe verbunden. in einem Splitterfilter stellt eine Eingabe eine Verbindung mit mehreren Ausgaben her. In diesen Fällen sollte die -Methode einfach E_NOTIMPL zurückgeben.

Andernfalls gibt die Methode ein Array von IPin-Zeigern zurück, eines für jeden Pin, der intern der abgefragten Pin zugeordnet ist. Wenn Sie die -Methode an einem Eingabenadel aufrufen, enthält das Array Zeiger auf Ausgabepins und umgekehrt.

Der Aufrufer ordnet das Array von IPin-Zeigern zu. Um die erforderliche Arraygröße abzurufen, rufen Sie die -Methode einmal mit apPin gleich NULL auf. Die Größe wird im nPin-Parameter zurückgegeben. Ordnen Sie dann das Array zu, und rufen Sie die Methode erneut auf, und legen Sie apPin gleich der Adresse des Arrays und nPin gleich der Arraygröße fest. Die -Methode füllt dann das Array mit IPin-Zeigern aus. Jeder zurückgegebene Zeiger verfügt über eine ausstehende Verweisanzahl und muss vom Aufrufer freigegeben werden.

Diese Methode hat eine weitere Verwendung, die jetzt veraltet ist: Der Filter Graph-Manager behandelt einen Filter als Rendererfilter, wenn mindestens ein Eingabenadel diese Methode implementiert, aber null in nPin zurückgibt. Wenn Sie jedoch einen neuen Rendererfilter schreiben, sollten Sie die IAMFilterMiscFlags-Schnittstelle implementieren, anstatt diese Methode zu verwenden, um anzugeben, dass der Filter ein Renderer ist.

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IPin-Schnittstelle