typedef struct {
LPBYTE lpData;
DWORD dwBufferLength;
DWORD dwBytesUsed;
DWORD dwTimeCaptured;
DWORD dwUser;
DWORD dwFlags;
DWORD dwReserved[4];
} VIDEOHDR;
The VIDEOHDR structure describes a client-supplied buffer for receiving video capture data. Drivers receive this structure along with DVM_STREAM_ADDBUFFER, DVM_STREAM_PREPAREHEADER, and DVM_STREAM_UNPREPAREHEADER messages. The structure is defined in msvideo.h.
Members
lpData
Pointer to a buffer.
dwBufferLength
Length of the buffer.
dwBytesUsed
Number of bytes used in the buffer.
dwTimeCaptured
Capture time for the frame, in milliseconds, relative to the capture time of the stream’s first frame.
dwUser
Contains 32 bits of client-specified data.
dwFlags
Contains flags. The following flags are defined.
| Flag | Definition |
| VHDR_DONE | Set by the device driver to indicate it is finished with the data buffer and is returning the buffer to the client. |
| VHDR_PREPARED | Indicates whether or not the buffer has been prepared for use. See DVM_STREAM_PREPAREHEADER. |
| VHDR_INQUEUE | Set by the driver to indicate the buffer is in the driver’s buffer queue. |
| VHDR_KEYFRAME | Set by the device driver to indicate a key frame. |
dwReserved[4]
Reserved for use by the device driver. Typically, drivers use this area to maintain a buffer queue.
Comments
The client supplies values for the lpData, dwBufferLength, and dwUser members. The driver fills in the dwBytesUsed, dwTimeCaptured, and dwFlags members. Drivers using VCUser.lib do not need to maintain the dwFlags member, because code within VCUser.lib handles the flags.