Compartir a través de


Método IAMFilterData::P arseFilterData

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Nota:

Esta interfaz está desusada. Las nuevas aplicaciones no deben usarlas.

 

El ParseFilterData método desempaqueta los datos del Registro binario para un filtro.

Normalmente, no hay ninguna razón para que una aplicación llame a este método. El método IFilterMapper2::EnumMatchingFilters proporciona una manera más cómoda de acceder a los datos del Registro de filtro.

Sintaxis

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

Parámetros

rgbFilterData [in]

Puntero a los datos del Registro binario. Para obtener estos datos, recupere la propiedad "FilterData" del moniker de filtro. Los datos se almacenan como SAFEARRAY de bytes (VT_UI1 | VT_ARRAY).

cb [in]

Especifica el tamaño de los datos binarios, en bytes.

prgbRegFilter2 [out]

Dirección de una variable que recibe un puntero a los datos desempaquetados. Cuando el método vuelve, convierta este puntero a un tipo REGFILTER2 para tener acceso a los datos de filtro. El llamador debe liberar la memoria llamando al método CoTaskMemFree .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.

Observaciones

Nota:

El encabezado Fil_data.h se encuentra en el directorio Mapper Sample (Ejemplo del asignador ) en Windows SDK.

 

Requisitos

Requisito Value
Encabezado
Fil_data.h
Archivo DLL
Quartz.dll

Consulte también

IAMFilterData (interfaz)