IAMFilterData::CreateFilterData-Methode

Hinweis

Diese Schnittstelle ist veraltet. Neue Anwendungen sollten sie nicht verwenden.

Die CreateFilterData -Methode erstellt binäre Registrierungsdaten für einen Filter. Diese Daten können als REG _ BINARY-Unterschlüssel mit dem Namen FilterData unter dem CLSID-Schlüssel des Filters in die Registrierung geschrieben werden.

Es gibt in der Regel keinen Grund für eine Anwendung, diese Methode aufzurufen. Die IFilterMapper2::RegisterFilter-Methode erstellt automatisch die Binärdaten und fügt sie dem richtigen Speicherort in der Registrierung hinzu. Weitere Informationen finden Sie unter Registrieren von DirectShow-Filtern.

Syntax

HRESULT CreateFilterData(
  [in]  REGFILTER2 *prf2,
  [out] BYTE       **prgbFilterData,
  [out] ULONG      *pcb
);

Parameter

prf2 [ In]

Zeiger auf eine REGFILTER2-Struktur, die die Filterinformationen enthält.

prgbFilterData [ out]

Adresse einer Variablen, die einen Zeiger auf die Binärdaten empfängt. Die -Methode ordnet den Arbeitsspeicher für die Daten zu. Der Aufrufer muss den Arbeitsspeicher freigeben, indem er die CoTaskMemFree-Methode aufruft.

- und -N [ out]

Zeiger auf eine Variable, die die Größe der Binärdaten in Bytes empfängt.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S _ OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Bemerkungen

Hinweis

Der Header Fil _ data.h befindet sich im Verzeichnis Mapper Sample im Windows SDK.

Requirements (Anforderungen)

Anforderung Wert
Header
Fil _ data.h
DLL
Quartz.dll

Weitere Informationen

IAMFilterData-Schnittstelle