CPullPin.Connect-Methode

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

Die Connect -Methode schließt eine Verbindung mit dem Ausgabenadel ab.

Syntax

HRESULT Connect(
   IUnknown      *pUnk,
   IMemAllocator *pAlloc,
   BOOL          bSync
);

Parameter

Punk

Zeiger auf die IUnknown-Schnittstelle des Ausgabenadels.

pAlloc

Zeiger auf die IMemAllocator-Schnittstelle des bevorzugten Zuordnungselements des Eingabenadels ( NULL).

bSync

Boolescher Wert, der angibt, ob synchrone Lesevorgänge verwendet werden sollen. Wenn TRUE, führt der Pin synchrone Lesevorgänge am Ausgabepin aus. Bei FALSE stellt der Pin asynchrone Leseanforderungen.

Rückgabewert

Gibt ein HRESULT zurück. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
S_OK
 Erfolg.
VFW_E_ALREADY_CONNECTED
 Der Eingabenadel ist bereits verbunden.
E_NOINTERFACE
 Der Ausgabepin macht IAsyncReader nicht verfügbar.

Bemerkungen

Rufen Sie diese Methode während des Verbindungsvorgangs des Eingabenadels auf. Wenn die Methode fehlschlägt, sollte der Pin die Verbindung nicht herstellen.

Diese Methode fragt den Ausgabepin für die IAsyncReader-Schnittstelle ab. Bei erfolgreicher Ausführung wird CPullPin::D ecideAllocator aufgerufen, um den Zuteilungsgeber für die Verbindung auszuhandeln. Wenn Ihr Eingabenadel über einen bevorzugten Zuteilungsstift verfügt, geben Sie ihn im pAlloc-Parameter an. Die DecideAllocator-Methode übergibt diesen Zeiger an die IAsyncReader::RequestAllocator-Methode des Ausgabepins. Legen Sie andernfalls pAlloc auf NULL fest.

Wenn der Wert von bSyncTRUE ist, stellt das CPullPin-Objekt synchrone Leseanforderungen durch Aufrufen des IAsyncReader::SyncReadAligned des Ausgabepins. Andernfalls wird die IAsyncReader::Request-Methode aufgerufen, um sich überlappende Leseanforderungen zu erstellen.

Anforderungen

Anforderung Wert
Header
Pullpin.h
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CPullPin-Klasse