CAPSTATUS - Win32 Multimedia Programmer's Reference

Custom Search

	Overview

	Group

	Quick Info

CAPSTATUS

The CAPSTATUS structure defines the current state of the capture window.

typedef struct {

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;

Members
uiImageWidth
Image width, in pixels.

uiImageHeight

Image height, in pixels

fLiveWindow

Live window flag. The value of this member is TRUE if the window is displaying video using the preview method.

fOverlayWindow

Overlay window flag. The value of this member is TRUE if the window is displaying video using hardware overlay.

fScale

Input scaling flag. The value of this member is TRUE if the window is scaling the input video to the client area when displaying video using preview. This parameter has no effect when displaying video using overlay.

ptScroll

The x- and y-offset of the pixel displayed in the upper left corner of the client area of the window.

fUsingDefaultPalette

Default palette flag. The value of this member is TRUE if the capture driver is using its default palette.

fAudioHardware

Audio hardware flag. The value of this member is TRUE if the system has waveform-audio hardware installed.

fCapFileExists

Capture file flag. The value of this member is TRUE if a valid capture file has been generated.

dwCurrentVideoFrame

Number of frames processed during the current (or most recent) streaming capture. This count includes dropped frames.

dwCurrentVideoFramesDropped

Number of frames dropped during the current (or most recent) streaming capture. Dropped frames occur when the capture rate exceeds the rate at which frames can be saved to file. In this case, the capture driver has no buffers available for storing data. Dropping frames does not affect synchronization because the previous frame is displayed in place of the dropped frame.

dwCurrentWaveSamples

Number of waveform-audio samples processed during the current (or most recent) streaming capture.

dwCurrentTimeElapsedMS

Time, in milliseconds, since the start of the current (or most recent) streaming capture.

hPalCurrent

Handle of current palette.

fCapturingNow

Capturing flag. The value of this member is TRUE when capturing is in progress.

dwReturn

Error return values. Use this member if your application does not support an error callback function.

wNumVideoAllocated

Number of video buffers allocated. This value might be less than the number specified in the wNumVideoRequested member of the CAPTUREPARMS structure.

wNumAudioAllocated

Number of audio buffers allocated. This value might be less than the number specified in the wNumAudioRequested member of the CAPTUREPARMS structure.

Remarks
Because the state of a capture window changes in response to various messages, an application should update the information in this structure whenever it needs to enable menu items, determine the actual state of the capture window, or call the video format dialog box. If the application yields during streaming capture, this structure returns the progress of the capture in the dwCurrentVideoFrame, dwCurrentVideoFramesDropped, dwCurrentWaveSamples, and dwCurrentTimeElapsedMS members. Use the WM_CAP_GET_STATUS message or capGetStatus macro to update the contents of this structure.

See Also
CAPTUREPARMS, WM_CAP_GET_STATUS

Last news from Greatis Software

    Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More »

Recommended software for developers

    Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More »

    Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More »

    Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More »

    Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More »

    Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More »

All the contacts and projects

Dmitry Vasiliev (just.dmitry)

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

greatis just4fun network