CreatePosPassThru-Funktion
[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 CreatePosPassThru Funktion erstellt ein CPosPassThru-Objekt oder ein CRendererPosPassThru-Objekt .
Syntax
STDAPI CreatePosPassThru(
LPUNKNOWN pAgg,
BOOL bRenderer,
IPin *pPin,
IUnknown **ppPassThru
);
Parameter
-
pAgg
-
Zeiger auf den Besitzer dieses Objekts. Wenn das Objekt aggregiert ist, übergeben Sie einen Zeiger auf die IUnknown-Schnittstelle des Aggregieren-Objekts. Legen Sie andernfalls diesen Parameter auf NULL fest.
-
bRenderer
-
Boolescher Wert, der angibt, ob der Filter ein Renderer ist. Verwenden Sie den Wert TRUE , wenn der Filter ein Renderer ist, oder andernfalls FALSE . Wenn der Wert TRUE ist, erstellt diese Methode eine instance der CRendererPosPassThru-Klasse. Wenn der Wert FALSE ist, erstellt die Methode eine instance der CPosPassThru-Klasse.
-
pPin
-
Zeiger auf die IPin-Schnittstelle am Eingabenadel des Filters.
-
ppPassThru
-
Adresse einer Variablen, die einen Zeiger auf die IUnknown-Schnittstelle des Objekts empfängt.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein HRESULT-Wert zurückgegeben, der die Fehlerursache angibt.
Bemerkungen
Diese Methode verwendet die ISeekingPassThru-Schnittstelle , um das -Objekt zu erstellen. Das Objekt wird dynamisch aus Quartz.dll geladen.
Wenn die Funktion erfolgreich ist, weist die zurückgegebene IUnknown-Schnittstelle eine ausstehende Verweisanzahl auf. Der Aufrufer muss die Schnittstelle freigeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|