Método ICaptureGraphBuilder2::AllocCapFile (strmif.h)
[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.
El AllocCapFile método preasigna un archivo de captura a un tamaño especificado. Para obtener los mejores resultados, capture siempre en un archivo de captura desfragmentado preasignado que sea mayor que el tamaño de los datos de captura.
Sintaxis
HRESULT AllocCapFile(
[in] LPCOLESTR lpstr,
[in] DWORDLONG dwlSize
);
Parámetros
[in] lpstr
Puntero a una cadena de caracteres anchos que contiene el nombre del archivo que se va a crear o cambiar el tamaño.
[in] dwlSize
Tamaño del archivo que se va a asignar, en bytes.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Este método produce un error si el archivo es de solo lectura.
Es mejor asignar tanto espacio como sea posible, idealmente, más de lo necesario. Sin embargo, esto puede dar lugar a un archivo muy grande que contiene relativamente pocos datos. Por ejemplo, un archivo de captura de 1 gigabyte (GB) puede contener algunos megabytes de vídeo capturado. Use el método ICaptureGraphBuilder2::CopyCaptureFile para copiar los datos en un nuevo archivo. Ese método copia solo los datos y omite la parte vacía del archivo original.
Si usa este método para prealcalizar el archivo, llame a IFileSinkFilter2::SetMode en el filtro file-writer con el valor cero. Si el filtro se establece en AM_FILE_OVERWRITE, eliminará el archivo asignado previamente. Tenga en cuenta que algunos filtros de escritor de archivos no admiten el modo 0.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluya Dshow.h) |
| Library | Strmiids.lib |