Compartir a través de


Método ICaptureGraphBuilder::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.

Nota La interfaz ICaptureGraphBuilder está en desuso. Use ICaptureGraphBuilder2 en su lugar.
 
Preasigna un archivo de captura a un tamaño especificado.

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, en bytes, del archivo que se va a asignar.

Valor devuelto

Devuelve un valor HRESULT .

Comentarios

Se producirá un error en la llamada si el archivo es de solo lectura. Para obtener mejores resultados de captura, capture siempre en un archivo de captura desfragmentado previamente asignado que sea mayor que el tamaño de los datos de captura.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado strmif.h (incluye Dshow.h)

Consulte también

Códigos de error y éxito

ICaptureGraphBuilder (interfaz)