Структура CAPTUREPARMS (vfw.h)
Структура CAPTUREPARMS содержит параметры, управляющие процессом захвата потокового видео. Эта структура используется для получения и задания параметров, влияющих на скорость записи, количество буферов, используемых при записи, и способ завершения записи.
Синтаксис
typedef struct tagCaptureParms {
DWORD dwRequestMicroSecPerFrame;
BOOL fMakeUserHitOKToCapture;
UINT wPercentDropForError;
BOOL fYield;
DWORD dwIndexSize;
UINT wChunkGranularity;
BOOL fUsingDOSMemory;
UINT wNumVideoRequested;
BOOL fCaptureAudio;
UINT wNumAudioRequested;
UINT vKeyAbort;
BOOL fAbortLeftMouse;
BOOL fAbortRightMouse;
BOOL fLimitEnabled;
UINT wTimeLimit;
BOOL fMCIControl;
BOOL fStepMCIDevice;
DWORD dwMCIStartTime;
DWORD dwMCIStopTime;
BOOL fStepCaptureAt2x;
UINT wStepCaptureAverageFrames;
DWORD dwAudioBufferSize;
BOOL fDisableWriteCache;
UINT AVStreamMaster;
} CAPTUREPARMS, *PCAPTUREPARMS, *LPCAPTUREPARMS;
Члены
dwRequestMicroSecPerFrame
Запрошенная частота кадров в микросекундах. Значение по умолчанию — 66667, что соответствует 15 кадрам в секунду.
fMakeUserHitOKToCapture
Флаг записи, инициированный пользователем. Если этот элемент имеет значение TRUE, AVICap отображает диалоговое окно с запросом на запуск записи. Значение по умолчанию — FALSE.
wPercentDropForError
Максимально допустимый процент удаленных кадров во время захвата. Допустимы значения от 0 до 100. Значение по умолчанию — 10.
fYield
Флаг доходности. Если этот элемент имеет значение TRUE, окно записи создает отдельный фоновый поток для выполнения пошаговой и потоковой записи. Значение по умолчанию — FALSE.
Приложения, задающие этот флаг, должны обрабатывать потенциальные проблемы повторного входа, так как элементы управления в приложении не отключаются во время записи.
dwIndexSize
Максимальное число записей индекса в AVI-файле. Значения варьируются от 1800 до 324 000. Если задано значение 0, используется значение по умолчанию 34 952 (32 КБ кадров плюс пропорциональное количество звуковых буферов).
Каждый видеокадр или буфер данных waveform-audio использует одну запись индекса. Значение этой записи устанавливает ограничение на количество кадров или звуковых буферов, которые можно записать.
wChunkGranularity
Размер логического блока (в байтах) файла AVI. Значение 0 указывает, что текущий размер сектора используется в качестве гранулярности.
fUsingDOSMemory
Не используется в приложениях Win32.
wNumVideoRequested
Максимальное количество выделенных видео буферов. Область памяти для размещения буферов указывается с помощью fUsingDOSMemory. Фактическое количество выделенных буферов может быть меньше, если память недоступна.
fCaptureAudio
Запись флага звука. Если этот элемент имеет значение TRUE, звук записывается во время записи потоковой передачи. Это значение по умолчанию, если установлено звуковое оборудование.
wNumAudioRequested
Максимальное количество выделенных звуковых буферов. Максимальное число буферов — 10.
vKeyAbort
Виртуальный код ключа, используемый для завершения записи потоковой передачи. Значение по умолчанию — VK_ESCAPE. Прежде чем указывать нажатие клавиши, необходимо вызвать функцию RegisterHotKey , которая может прервать сеанс записи.
Вы можете объединить ключевые коды, включающие нажатия клавиш CTRL и SHIFT, с помощью логического оператора OR с кодами клавиш CTRL (0x8000) и SHIFT (0x4000).
fAbortLeftMouse
Флаг прерывания для левой кнопки мыши. Если этот элемент имеет значение TRUE, потоковый захват останавливается при нажатии левой кнопки мыши. Значение по умолчанию — TRUE.
fAbortRightMouse
Флаг прерывания для правой кнопки мыши. Если этот элемент имеет значение TRUE, потоковый захват останавливается при нажатии правой кнопки мыши. Значение по умолчанию — TRUE.
fLimitEnabled
Флаг включенного ограничения по времени. Если этот элемент имеет значение TRUE, запись потоковой передачи останавливается по истечении времени в секундах в wTimeLimit . Значение по умолчанию — FALSE.
wTimeLimit
Ограничение времени для записи в секундах. Этот параметр используется, только если fLimitEnabled имеет значение TRUE.
fMCIControl
Флаг захвата устройств MCI. Если этот элемент имеет значение TRUE, AVICap управляет источником видео, совместимым с MCI, во время записи потоковой передачи. Источники видео, совместимые с MCI, включают видео- и лазерные дискы.
fStepMCIDevice
Флаг записи шага устройства MCI. Если этот элемент имеет значение TRUE, запись шагов с помощью устройства MCI в качестве источника видео включена. Если задано значение FALSE, запись в режиме реального времени с помощью устройства MCI включена. (Если fMCIControl имеет значение FALSE, этот элемент игнорируется.)
dwMCIStartTime
Начальная позиция (в миллисекундах) устройства MCI для последовательности захвата. (Если fMCIControl имеет значение FALSE, этот элемент игнорируется.)
dwMCIStopTime
Позиция остановки (в миллисекундах) устройства MCI для последовательности захвата. Когда эта позиция в содержимом достигнута, запись завершается и устройство MCI останавливается. (Если fMCIControl имеет значение FALSE, этот элемент игнорируется.)
fStepCaptureAt2x
Флаг записи шага двойного разрешения. Если этот элемент имеет значение TRUE, оборудование захвата фиксирует в два раза указанное разрешение. (Разрешение для высоты и ширины удвояется.)
Включите этот параметр, если оборудование не поддерживает аппаратное декимирование и выполняется запись в формате RGB.
wStepCaptureAverageFrames
Количество выборок кадра при создании кадра на основе средней выборки. Типичное значение для среднего числа — 5.
dwAudioBufferSize
Размер звукового буфера. Если используется нулевое значение по умолчанию, размер каждого буфера будет составлять не более 0,5 секунд аудио или 10 000 байт.
fDisableWriteCache
Не используется в приложениях Win32.
AVStreamMaster
Указывает, управляет ли звуковой поток часами при записи AVI-файла. Если для этого элемента задано значение AVSTREAMMASTER_AUDIO, аудиопоток считается потоком master, а длительность видеопотока принудительно соответствует длительности звука. Если для этого элемента задано значение AVSTREAMMASTER_NONE, продолжительность аудио- и видеопотоков может отличаться.
Комментарии
Для получения текущих параметров записи используется сообщение WM_CAP_GET_SEQUENCE_SETUP или макрос capCaptureGetSetup . Для задания параметров записи используется сообщение WM_CAP_SET_SEQUENCE_SETUP или макрос capCaptureSetSetup .
Для получения текущих параметров записи используется сообщение WM_CAP_GET_SEQUENCE_SETUP или макрос capCaptureGetSetup . Для задания параметров записи используется WM_CAP_SET_SEQUENCE_SETUP message или макрос capCaptureSetSetup.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | vfw.h |
См. также раздел
Запись видео