Структура CAPSTATUS (vfw.h)

Структура CAPSTATUS определяет текущее состояние окна записи.

Синтаксис

typedef struct tagCapStatus {
  UINT     uiImageWidth;
  UINT     uiImageHeight;
  BOOL     fLiveWindow;
  BOOL     fOverlayWindow;
  BOOL     fScale;
  POINT    ptScroll;
  BOOL     fUsingDefaultPalette;
  BOOL     fAudioHardware;
  BOOL     fCapFileExists;
  DWORD    dwCurrentVideoFrame;
  DWORD    dwCurrentVideoFramesDropped;
  DWORD    dwCurrentWaveSamples;
  DWORD    dwCurrentTimeElapsedMS;
  HPALETTE hPalCurrent;
  BOOL     fCapturingNow;
  DWORD    dwReturn;
  UINT     wNumVideoAllocated;
  UINT     wNumAudioAllocated;
} CAPSTATUS, *PCAPSTATUS, *LPCAPSTATUS;

Члены

uiImageWidth

Ширина изображения в пикселях.

uiImageHeight

Высота изображения в пикселях

fLiveWindow

Флаг динамического окна. Значение этого элемента равно TRUE , если в окне отображается видео с помощью метода предварительного просмотра.

fOverlayWindow

Флаг окна наложения. Значение этого элемента равно TRUE , если в окне отображается видео с использованием аппаратного наложения.

fScale

Флаг масштабирования входных данных. Значение этого элемента равно TRUE , если окно масштабируется входное видео до клиентской области при отображении видео с помощью предварительного просмотра. Этот параметр не влияет на отображение видео с помощью наложения.

ptScroll

Смещение x и y пикселя, отображаемое в левом верхнем углу клиентской области окна.

fUsingDefaultPalette

Флаг палитры по умолчанию. Значение этого элемента равно TRUE , если драйвер захвата использует палитру по умолчанию.

fAudioHardware

Флаг звукового оборудования. Значение этого элемента равно TRUE , если в системе установлено оборудование waveform-audio.

fCapFileExists

Флаг файла записи. Значение этого элемента равно TRUE , если был создан допустимый файл записи.

dwCurrentVideoFrame

Количество кадров, обработанных во время текущего (или последнего) захвата потоковой передачи. Это число включает удаленные кадры.

dwCurrentVideoFramesDropped

Количество кадров, удаленных во время текущего (или последнего) захвата потоковой передачи. Удаленные кадры возникают, когда скорость записи превышает скорость, с которой кадры могут быть сохранены в файл. В этом случае драйвер записи не имеет буферов, доступных для хранения данных. Удаление кадров не влияет на синхронизацию, так как предыдущий кадр отображается вместо отброшенного кадра.

dwCurrentWaveSamples

Количество образцов waveform-audio, обработанных во время текущего (или последнего) захвата потоковой передачи.

dwCurrentTimeElapsedMS

Время (в миллисекундах) с начала текущего (или последнего) захвата потоковой передачи.

hPalCurrent

Дескриптор текущей палитры.

fCapturingNow

Флаг записи. Значение этого элемента — TRUE , когда выполняется запись.

dwReturn

Возвращаемые значения ошибок. Используйте этот член, если приложение не поддерживает функцию обратного вызова ошибок.

wNumVideoAllocated

Количество выделенных буферов видео. Это значение может быть меньше числа, указанного в элементе wNumVideoRequested структуры CAPTUREPARMS .

wNumAudioAllocated

Количество выделенных звуковых буферов. Это значение может быть меньше числа, указанного в элементе wNumAudioRequested структуры CAPTUREPARMS .

Комментарии

Так как состояние окна записи изменяется в ответ на различные сообщения, приложение должно обновлять сведения в этой структуре всякий раз, когда ему нужно включить пункты меню, определить фактическое состояние окна записи или вызвать диалоговое окно формата видео. Если приложение возвращает данные во время записи потоковой передачи, эта структура возвращает ход выполнения записи в членах dwCurrentVideoFrame, dwCurrentVideoFramesDropped, dwCurrentWaveSamples и dwCurrentTimeElapsedMS . Используйте WM_CAP_GET_STATUS сообщение или макрос capGetStatus , чтобы обновить содержимое этой структуры.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	vfw.h

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

CAPTUREPARMS

Запись видео

Структуры захвата видео

WM_CAP_GET_STATUS