IAMFilterData::CreateFilterData-Methode
[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.]
Hinweis
Diese Schnittstelle ist veraltet. Neue Anwendungen sollten es nicht verwenden.
Die CreateFilterData -Methode erstellt binäre Registrierungsdaten für einen Filter. Diese Daten können als REG_BINARY Unterschlüssel namens FilterData unter dem CLSID-Schlüssel des Filters in die Registrierung geschrieben werden.
In der Regel gibt es keinen Grund für eine Anwendung, diese Methode aufzurufen. Die IFilterMapper2::RegisterFilter-Methode erstellt die Binärdaten automatisch 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.
-
pcb [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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| DLL |
|
Siehe auch