IAMCrossbar::get_CrossbarPinInfo-Methode (strmif.h)

Artikel
03/04/2024

[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.]

Die get_CrossbarPinInfo -Methode ruft Informationen zu einem angegebenen Pin ab.

Syntax

HRESULT get_CrossbarPinInfo(
  [in]  BOOL IsInputPin,
  [in]  long PinIndex,
  [out] long *PinIndexRelated,
  [out] long *PhysicalType
);

Parameter

[in] IsInputPin

Gibt die Richtung des Stifts an. Verwenden Sie einen der folgenden Werte.

Wert	Bedeutung
STIMMT	Eingabenadel
FALSE	Ausgabenadel

[in] PinIndex

Gibt den Index des Pins an.

[out] PinIndexRelated

Zeiger auf eine Variable, die den Index des zugehörigen Pins empfängt, oder –1, wenn kein Pin mit diesem Pin verknüpft ist. Der zugehörige Pin ist ein Pin auf demselben Filter mit der gleichen Richtung. Sie stellt in der Regel denselben physischen Anschluss oder Stecker dar. Beispielsweise können ein Videotuner und ein Audiotuner verwandte Pins sein. Wenn zwei Pins miteinander verknüpft sind, sollten Sie diese in der Regel zusammen weiterleiten.

[out] PhysicalType

Zeiger auf eine Variable, die ein Element der PhysicalConnectorType-Enumeration empfängt und den physischen Typ des Pins angibt.

Rückgabewert

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

Rückgabecode	Beschreibung
S_FALSE	Unbekannter physischer Typ.
S_OK	Erfolg.
E_POINTER	NULL-Zeigerargument.

Hinweise

Ausgabepins und Eingabepins werden beide von 0 indiziert. Um die Anzahl der Ausgabe- und Eingabenadeln zu bestimmen, rufen Sie die IAMCrossbar::get_PinCounts-Methode auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IAMCrossbar-Schnittstelle

Arbeiten mit Querleisten

Freigeben über