Metodo IAMFilterData::P arseFilterData

[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 ParseFilterData metodo decomprime i dati del Registro di sistema binario per un filtro.

In genere non c'è motivo per un'applicazione di chiamare questo metodo. Il metodo IFilterMapper2::EnumMatchingFilters offre un modo più pratico per accedere ai dati del Registro di sistema di filtro.

Sintassi

HRESULT ParseFilterData(
  [in]  BYTE  *rgbFilterData,
  [in]  ULONG cb,
  [out] BYTE  **prgbRegFilter2
);

Parametri

rgbFilterData [in]

Puntatore ai dati del Registro di sistema binario. È possibile ottenere questi dati recuperando la proprietà "FilterData" dal moniker del filtro. I dati vengono archiviati come SAFEARRAY di byte (VT_UI1 | VT_ARRAY).

cb [in]

Specifica le dimensioni dei dati binari, in byte.

prgbRegFilter2 [out]

Indirizzo di una variabile che riceve un puntatore ai dati non compressi. Quando il metodo restituisce, eseguire il cast di questo puntatore a un tipo REGFILTER2 per accedere ai dati del filtro. Il chiamante deve rilasciare la memoria chiamando il metodo CoTaskMemFree .

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