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 |
|
| DLL |
|