StretchDIBits

        该函数将DIB中矩形区域内像素使用的颜色数据拷贝到指定的目标矩形中。如果目标矩形比源矩形大小要大，那么函数对颜色数据的行和列进行拉伸，以与目标矩形匹配。如果目标矩形大小要比源矩形小，那么该函数通过使用指定的光栅操作对行列进行压缩。

        函数原型：

        int StretchDIBits(HDC hdc, int XDest , int YDest , int nDestWidth, int nDestHeight, int XSrc, int YSrc, int nSrcWidth, int nSrcHeight, CONST VOID *lpBits, CONST BITMAPINFO * lpBitsInfo, UINT iUsage, DWORD dwRop)；

        hdc：指向目标设备环境的句柄。

        XDest：指定目标矩形左上角位置的X轴坐标，按逻辑单位来表示坐标。

        YDest：指定目标矩形左上角的Y轴坐标，按逻辑单位表示坐标。

        nDestWidth：指定目标矩形的宽度。

        nDestHeight：指定目标矩形的高度。

        XSrc：指定DIB中源矩形（左上角）的X轴坐标，坐标以像素点表示。

        YSrc：指定DIB中源矩形（左上角）的Y轴坐标，坐标以像素点表示。

        nSrcWidth：按像素点指定DIB中源矩形的宽度。

        nSrcHeight：按像素点指定DIB中源矩形的高度。

        lpBits：指向DIB位的指针，这些位的值按字节类型数组存储，有关更多的信息，参考下面的备注一节。

        lpBitsInfo：指向BITMAPINFO结构的指针，该结构包含有关DIB方面的信息。

        iUsage：表示是否提供了BITMAPINFO结构中的成员bmiColors，如果提供了，那么该bmiColors是否包含了明确的RGB值或索引。参数iUsage必须取下列值，这些值的含义如下：

        DIB_PAL_COLORS：表示该数组包含对源设备环境的逻辑调色板进行索引的16位索引值。

        DIB_RGB_COLORS：表示该颜色表包含原义的RGB值，若想了解更多的信息，请参考下面备注一节。

        dwRop：指定源像素点、目标设备环境的当前刷子和目标像素点是如何组合形成新的图像。若想了解更多信息，请参考下面的备注一节。

        返回值：如果函数执行成功，那么返回值是拷贝的扫描线数目，如果函数执行失败，那么返回值是GDI_ERROR。