Поделиться через

Метод ICaptureGraphBuilder::AllocCapFile (strmif.h)

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Примечание Интерфейс ICaptureGraphBuilder не рекомендуется использовать. Вместо этого используйте ICaptureGraphBuilder2 .
 
Предварительно выделяет файл записи до указанного размера.

Синтаксис

HRESULT AllocCapFile(
  [in] LPCOLESTR lpstr,
  [in] DWORDLONG dwlSize
);

Параметры

[in] lpstr

Указатель на строку расширенных символов, содержащую имя файла для создания или изменения размера.

[in] dwlSize

Размер выделяемого файла (в байтах).

Возвращаемое значение

Возвращает значение HRESULT .

Комментарии

Вызов завершится ошибкой, если файл доступен только для чтения. Для получения наилучших результатов записи всегда записывайте данные в дефрагментированный предварительно выделяемый файл записи, который больше размера данных записи.

Требования

Требование Значение
Целевая платформа Windows
Header strmif.h (включая Dshow.h)

См. также раздел

Коды ошибок и успешного выполнения

Интерфейс ICaptureGraphBuilder