Click here to Skip to main content
15,851,243 members
Articles / Programming Languages / C#

Steganography IV - Reading and Writing AVI files

Rate me:
Please Sign up or sign in to vote.
4.89/5 (56 votes)
19 May 2004CPOL4 min read 509.8K   12.4K   116   139
An article about hiding bytes in the bitmap frames of uncompressed AVI files.


The video stream in an AVI file is nothing more than a sequence of bitmaps. This article is about extracting these bitmaps and re-building the stream, in order to hide a message in the video.


Before reading this article, you should have read at least part one, Steganography - Hiding messages in the Noise of a Picture. This one uses the application described in parts 1-3, but you don’t need the extended features to understand it.

Reading the Video Stream

The Windows AVI library is a set of functions in avifil32.dll. Before it is ready to use, it has to be initialized with AVIFileInit. AVIFileOpen opens the file, AVIFileGetStream finds the video stream. Each of these functions allocates memory which has to be released.

//Initialize the AVI library
public static extern void AVIFileInit();

//Open an AVI file
[DllImport("avifil32.dll", PreserveSig=true)]
public static extern int AVIFileOpen(
    ref int ppfile,
    String szFile,
    int uMode,
    int pclsidHandler);

//Get a stream from an open AVI file
public static extern int AVIFileGetStream(
    int pfile,
    out IntPtr ppavi,  
    int fccType,       
    int lParam);

//Release an open AVI stream
public static extern int AVIStreamRelease(IntPtr aviStream);

//Release an ope AVI file
public static extern int AVIFileRelease(int pfile);

//Close the AVI library
public static extern void AVIFileExit();

Now we are able to open an AVI file and get the video stream. AVI files can contain many streams of four different types (Video, Audio, Midi and Text). Usually there is only one stream of each type, and we are only interested in the video stream.

private int aviFile = 0;
private IntPtr aviStream;

public void Open(string fileName) {
    AVIFileInit(); //Intitialize AVI library
    //Open the file
    int result = AVIFileOpen(
        ref aviFile,
        OF_SHARE_DENY_WRITE, 0);
    //Get the video stream
    result = AVIFileGetStream(
        out aviStream,
        streamtypeVIDEO, 0);

Before we start reading the frames, we must know what exactly we want to read:

  • Where does the first frame begin?
  • How many frames are available?
  • What is the height/width of the images?

The AVI library contains a function for every question.

//Get the start position of a stream
[DllImport("avifil32.dll", PreserveSig=true)]
public static extern int AVIStreamStart(int pavi);

//Get the length of a stream in frames
[DllImport("avifil32.dll", PreserveSig=true)]
public static extern int AVIStreamLength(int pavi);

//Get header information about an open stream
public static extern int AVIStreamInfo(
    int pAVIStream,
    ref AVISTREAMINFO psi,
    int lSize);

With these functions we can fill a BITMAPINFOHEADER structure. To extract the images, we need three more functions.

//Get a pointer to a GETFRAME object (returns 0 on error)
public static extern int AVIStreamGetFrameOpen(
    IntPtr pAVIStream,

//Get a pointer to a packed DIB (returns 0 on error)
public static extern int AVIStreamGetFrame(
    int pGetFrameObj,
    int lPos);

//Release the GETFRAME object
public static extern int AVIStreamGetFrameClose(int pGetFrameObj);

Finally we are ready to decompress the frames...

//get start position and count of frames
int firstFrame = AVIStreamStart(aviStream.ToInt32());
int countFrames = AVIStreamLength(aviStream.ToInt32());

//get header information            
result = AVIStreamInfo(aviStream.ToInt32(), ref streamInfo,

//construct the expected bitmap header
bih.biBitCount = 24;
bih.biCompression = 0; //BI_RGB;
bih.biHeight = (Int32)streamInfo.rcFrame.bottom;
bih.biWidth = (Int32)streamInfo.rcFrame.right;
bih.biPlanes = 1;
bih.biSize = (UInt32)Marshal.SizeOf(bih);

//prepare to decompress DIBs (device independend bitmaps)
int getFrameObject = AVIStreamGetFrameOpen(aviStream, ref bih);


//Export the frame at the specified position
public void ExportBitmap(int position, String dstFileName){
    //Decompress the frame and return a pointer to the DIB
    int pDib = Avi.AVIStreamGetFrame(getFrameObject, firstFrame + position);

    //Copy the bitmap header into a managed struct
    bih = (BITMAPINFOHEADER)Marshal.PtrToStructure(new IntPtr(pDib),
    //Copy the image
    byte[] bitmapData = new byte[bih.biSizeImage];
    int address = pDib + Marshal.SizeOf(bih);
    for(int offset=0; offset<bitmapData.Length; offset++){
        bitmapData[offset] = Marshal.ReadByte(new IntPtr(address));

    //Copy bitmap info
    byte[] bitmapInfo = new byte[Marshal.SizeOf(bih)];
    IntPtr ptr;
    ptr = Marshal.AllocHGlobal(bitmapInfo.Length);
    Marshal.StructureToPtr(bih, ptr, false);
    address = ptr.ToInt32();
    for(int offset=0; offset<bitmapInfo.Length; offset++){
        bitmapInfo[offset] = Marshal.ReadByte(new IntPtr(address));

...and store them in bitmap files.

    //Create file header
    bfh.bfType = Avi.BMP_MAGIC_COOKIE;
    //size of file as written to disk

    bfh.bfSize = (Int32)(55 + bih.biSizeImage);
    bfh.bfOffBits = Marshal.SizeOf(bih) + Marshal.SizeOf(bfh);

    //Create or overwrite the destination file
    FileStream fs = new FileStream(dstFileName, System.IO.FileMode.Create);
    BinaryWriter bw = new BinaryWriter(fs);

    //Write header
    //Write bitmap info
    //Write bitmap data
} //end of ExportBitmap

The application can use the extracted bitmaps just like any other image file. If one carrier file is an AVI video, it extracts the first frame to a temporary file, opens it and hides a part of the message. Then it writes the resulting bitmap to a new video stream, and continues with the next frame. After the last frame the application closes both video files, deletes the temporary bitmap file, and continues with the next carrier file.

Writing to a Video Stream

When the application opens an AVI carrier file, it creates another AVI file for the resulting bitmaps. The new video stream must have the same size and frame rate as the original stream, so we cannot create it in the Open() method. When the first bitmap arrives, we know the frame size and are able to create a video stream. The functions to create streams and write frames are AVIFileCreateStream, AVIStreamSetFormat and AVIStreamWrite:

//Create a new stream in an open AVI file
public static extern int AVIFileCreateStream(
    int pfile,
    out IntPtr ppavi, 
    ref AVISTREAMINFO ptr_streaminfo);

//Set the format for a new stream
public static extern int AVIStreamSetFormat(
    IntPtr aviStream, Int32 lPos, 
    ref BITMAPINFOHEADER lpFormat, Int32 cbFormat);

//Write a sample to a stream
public static extern int AVIStreamWrite(
    IntPtr aviStream, Int32 lStart, Int32 lSamples, 
    IntPtr lpBuffer, Int32 cbBuffer, Int32 dwFlags, 
    Int32 dummy1, Int32 dummy2);

Now we can create a stream...

//Create a new video stream
private void CreateStream() {
    //describe the stream to create
    strhdr.fccType = this.fccType; //mmioStringToFOURCC("vids", 0)
    strhdr.fccHandler = this.fccHandler; //"Microsoft Video 1"
    strhdr.dwScale = 1;
    strhdr.dwRate = frameRate;
    strhdr.dwSuggestedBufferSize = (UInt32)(height * stride);
    //use highest quality! Compression destroys the hidden message.
    strhdr.dwQuality = 10000;
    strhdr.rcFrame.bottom = (UInt32)height;
    strhdr.rcFrame.right = (UInt32)width;
    strhdr.szName = new UInt16[64];
    //create the stream
    int result = AVIFileCreateStream(aviFile, out aviStream, ref strhdr);

    //define the image format
    bi.biSize      = (UInt32)Marshal.SizeOf(bi);
    bi.biWidth     = (Int32)width;
    bi.biHeight    = (Int32)height;
    bi.biPlanes    = 1;
    bi.biBitCount  = 24;
    bi.biSizeImage = (UInt32)(this.stride * this.height);

    //format the stream
    result = Avi.AVIStreamSetFormat(aviStream, 0, ref bi, Marshal.SizeOf(bi));

...and write video frames.

//Create an empty AVI file
public void Open(string fileName, UInt32 frameRate) {
    this.frameRate = frameRate;

    int hr = Avi.AVIFileOpen(
        ref aviFile, fileName, 
        OF_WRITE | OF_CREATE, 0);

//Add a sample to the stream - for first sample: create the stream 
public void AddFrame(Bitmap bmp) {
    BitmapData bmpDat = bmp.LockBits(
        new Rectangle(0, 0, bmp.Width, bmp.Height),

    //this is the first frame - get size and create a new stream
    if (this.countFrames == 0) {
        this.stride = (UInt32)bmpDat.Stride;
        this.width = bmp.Width;
        this.height = bmp.Height;
        CreateStream(); //a method to create a new video stream

    //add the bitmap to the stream
    int result = AVIStreamWrite(aviStream,
        countFrames, 1, 
        bmpDat.Scan0, //pointer to the beginning of the image data
        (Int32) (stride  * height), 
        0, 0, 0); 

    this.countFrames ++;

That's all we need to read and write video streams. Non-video streams and compression are not interesting at the moment, because compression destroys the hidden message by changing colours, and sound would make the files even larger - uncompressed AVI files are big enough! ;-)

Changes in CryptUtility

The HideOrExtract() method used to load all carrier images at once. This was no good from the beginning, and now it became impossible. From now on HideOrExtract() loads only one bitmap, and disposes it before loading the next one. The currently used carrier image - simple bitmap or extracted AVI frame - is stored in a BitmapInfo structure, which is passed around by ref.
public struct BitmapInfo{
    //uncompressed image
    public Bitmap bitmap;
    //position of the frame in the AVI stream, -1 for non-avi bitmaps
    public int aviPosition;
    //count of frames in the AVI stream, or 0 for non-avi bitmaps
    public int aviCountFrames;
    //path and name of the bitmap file
    //this file will be deleted later, if aviPosition is 0 or greater
    public String sourceFileName;
    //how many bytes will be hidden in this image
    public long messageBytesToHide;

    public void LoadBitmap(String fileName){
        bitmap = new Bitmap(fileName);
        sourceFileName = fileName;

Whenever MovePixelPosition moves the position into the next carrier bitmap, it checks the field aviPosition. If aviPosition is < 0, it saves and disposes the bitmap. If aviPosition is 0 or greater, it is a frame in an AVI stream. It is not saved to a file, but added to the open AVI stream. If the bitmap was a simple image or the last frame of an AVI stream, the method opens the next carrier file. If there are more frames in the AVI stream, is exports and loads the next bitmap.

Using the code

There are three new classes in the project:

  • AviReader opens existing AVI files and copies frames to bitmap files.
  • AviWriter creates new AVI files and combines bitmaps to a video stream.
  • Avi contains the function declarations and structure definitions.


Thanks to Shrinkwrap Visual Basic, for the "Visual Basic AVIFile Tutorial". The examples could not be easily converted to VB.NET or C#, but they gave me important hints on how to copy DIBs.

Thanks to Rene N., who posted an AviWriter class in microsoft.public.dotnet.languages.csharp.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Written By
Software Developer
Germany Germany
Corinna lives in Hanover/Germany and works as a C# developer.

Comments and Discussions

QuestionHow can i get audio in converted video ? Plz reply.. Pin
thats_rangan12-Jul-10 20:48
thats_rangan12-Jul-10 20:48 
AnswerRe: How can i get audio in converted video ? Plz reply.. Pin
Corinna John12-Jul-10 22:06
Corinna John12-Jul-10 22:06 
Generalcould you please explain for this code ??? [modified] Pin
quang moi 123-Jun-10 22:54
quang moi 123-Jun-10 22:54 
GeneralRe: could you please this code ??? Pin
Corinna John24-Jun-10 0:02
Corinna John24-Jun-10 0:02 
GeneralRe: could you please this code ??? Pin
quang moi 124-Jun-10 2:39
quang moi 124-Jun-10 2:39 
GeneralRe: could you please explain for this code ??? Pin
quang moi 124-Jun-10 3:44
quang moi 124-Jun-10 3:44 
QuestionHow I could compress the Bitmaps that I put in the AVI file Pin
molinarius7-May-10 5:44
molinarius7-May-10 5:44 
AnswerRe: How I could compress the Bitmaps that I put in the AVI file Pin
Corinna John24-Jun-10 0:03
Corinna John24-Jun-10 0:03 
This simple How-To uses Least Significant Bit steganogography. So, it doesn't support compressed bitmaps. Wink | ;)
This statement is false.

Generalmany frames are ignored Pin
CryproKit29-Apr-10 23:58
CryproKit29-Apr-10 23:58 
GeneralRe: many frames are ignored Pin
Corinna John30-Apr-10 11:57
Corinna John30-Apr-10 11:57 
GeneralRe: many frames are ignored Pin
CryproKit2-May-10 6:17
CryproKit2-May-10 6:17 
GeneralRe: many frames are ignored Pin
CryproKit1-Jun-10 4:57
CryproKit1-Jun-10 4:57 
GeneralRe: many frames are ignored Pin
Corinna John1-Jun-10 5:17
Corinna John1-Jun-10 5:17 
GeneralRe: many frames are ignored Pin
CryproKit5-Jun-10 17:18
CryproKit5-Jun-10 17:18 
GeneralError:The instruction at "0x10001862" referenced memory at "0x00000004". The memory could not be read Pin
samwitwicky13-Apr-10 22:06
samwitwicky13-Apr-10 22:06 
Questiongetting Exception on running the code Pin
samwitwicky15-Mar-10 19:39
samwitwicky15-Mar-10 19:39 
AnswerRe: getting Exception on running the code Pin
Corinna John15-Mar-10 23:18
Corinna John15-Mar-10 23:18 
GeneralRe: getting Exception on running the code Pin
samwitwicky17-Mar-10 5:07
samwitwicky17-Mar-10 5:07 
GeneralThe AVI seems to work but it's black Pin
dereklac20-Dec-09 19:04
dereklac20-Dec-09 19:04 
Generalvideo steganography Pin
lakshman5079-Dec-09 23:16
lakshman5079-Dec-09 23:16 
QuestionSample examples for hiding a text in to mp3 file Pin
Ganesht_200030-Nov-09 1:50
Ganesht_200030-Nov-09 1:50 
GeneralUpside down Pin
PeterFortuin10-Sep-09 2:54
PeterFortuin10-Sep-09 2:54 
QuestionVideo compression [modified] Pin
DanInManchester21-Jun-09 1:23
DanInManchester21-Jun-09 1:23 
AnswerRe: Video compression Pin
Corinna John21-Jun-09 1:34
Corinna John21-Jun-09 1:34 
GeneralRe: Video compression Pin
DanInManchester30-Jun-09 6:41
DanInManchester30-Jun-09 6:41 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.