Condividi tramite


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
Fil_data.h
DLL
Quartz.dll

Vedi anche

Interfaccia IAMFilterData