Metodo IAMFilterData::CreateFilterData
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Nota
Questa interfaccia è stata deprecata. Le nuove applicazioni non devono usarle.
Il CreateFilterData metodo crea dati del Registro di sistema binari per un filtro. Questi dati possono essere scritti nel Registro di sistema come sottochiave REG_BINARY denominata FilterData, nella chiave CLSID del filtro.
In genere non c'è motivo per un'applicazione di chiamare questo metodo. Il metodo IFilterMapper2::RegisterFilter crea automaticamente i dati binari e lo aggiunge alla posizione corretta nel Registro di sistema. Per altre informazioni, vedere Come registrare filtri DirectShow.
Sintassi
HRESULT CreateFilterData(
[in] REGFILTER2 *prf2,
[out] BYTE **prgbFilterData,
[out] ULONG *pcb
);
Parametri
-
prf2 [in]
-
Puntatore a una struttura REGFILTER2 contenente le informazioni sul filtro.
-
prgbFilterData [out]
-
Indirizzo di una variabile che riceve un puntatore ai dati binari. Il metodo alloca la memoria per i dati. Il chiamante deve rilasciare la memoria chiamando il metodo CoTaskMemFree .
-
pcb [out]
-
Puntatore a una variabile che riceve le dimensioni dei dati binari, in byte.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.
Commenti
Nota
L'intestazione Fil_data.h si trova nella directory Di esempio mapper in Windows SDK.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| DLL |
|
Vedi anche