CPullPin.Connect-Methode
[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 |
|---|---|
|
Erfolg. |
|
Der Eingabenadel ist bereits verbunden. |
|
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 |
|
| Bibliothek |
|