//---------------------------------------------------------------------------
//  Screenshot - Copyright © 2001 Michael Fötsch.
//
//  Source code for my tutorial "Taking Screenshots with Direct3D 8"
//  at www.mr-gamemaker.com.
//
//  Visit my homepage: http://www.geocities.com/foetsch
//  Contact me: foetsch@yahoo.com
//
//  You can download the Borland-compatible LIB files for DirectX 8
//  from http://www.geocities.com/foetsch.
//---------------------------------------------------------------------------

#ifndef ScreenshotH
#define ScreenshotH

#include <windows.h>
#include <d3d8.h>

// Screenshot
//  [in] lpDevice: The Direct3D device from which to take a screenshot.
//  [in] lpszFileName: Full path of the bitmap file to which the screenshot
//      should be saved. If this is NULL, a unique filename is generated
//      and the file is saved in a sub-folder (as specified by
//      SCREENSHOT_REL_PATH) of the folder that contains the EXE file.
//  Return value: S_OK on success. If SCREENSHOT_DONT_THROW is not defined,
//      the function throws an exception when an error occurs (this is the
//      default behavior). If SCREENSHOT_DONT_THROW is defined, the
//      function return E_FAIL when an error occurs.
//
HRESULT Screenshot(
    LPDIRECT3DDEVICE8 lpDevice,
    const char* lpszFileName = NULL
);

#endif ScreenshotH