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

Siehe auch

CPosPassThru-Klasse