Método IAMFilterData::CreateFilterData
[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 CreateFilterData método crea datos binarios del Registro para un filtro. Estos datos se pueden escribir en el Registro como una subclave REG_BINARY denominada FilterData, en la clave CLSID del filtro.
Normalmente, no hay ninguna razón para que una aplicación llame a este método. El método IFilterMapper2::RegisterFilter crea automáticamente los datos binarios y los agrega a la ubicación correcta en el registro. Para obtener más información, vea Cómo registrar filtros directShow.
Sintaxis
HRESULT CreateFilterData(
[in] REGFILTER2 *prf2,
[out] BYTE **prgbFilterData,
[out] ULONG *pcb
);
Parámetros
-
prf2 [in]
-
Puntero a una estructura REGFILTER2 que contiene la información de filtro.
-
prgbFilterData [out]
-
Dirección de una variable que recibe un puntero a los datos binarios. El método asigna la memoria de los datos. El llamador debe liberar la memoria llamando al método CoTaskMemFree .
-
pcb [out]
-
Puntero a una variable que recibe el tamaño de los datos binarios, en bytes.
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 |
|
| Archivo DLL |
|
Consulte también