GetDeviceCaps

小甲鱼

函数功能：

GetDeviceCaps 函数用于获得指定设备的一些特定信息。


API 函数原型：

注释：_In_ 说明该参数是输入的。

int GetDeviceCaps(
  _In_  HDC hdc,
  _In_  int nIndex
);

参数解析：

参数	含义
hdc	设备环境句柄
nIndex	索引值，根据这个索引值该函数获得并返回相应信息的值

nIndex 的索引值可以是以下值：

索引值	含义
DRIVERVERSION	设备驱动程序版本
TECHNOLOGY	1. 设备技术，可以是下列任何一个值： DT_PLOTTER 矢量绘图仪 DT_RASDISPLAY 光栅显示器 DT_RASPRINTER 光栅打印机 DT_RASCAMERA 光栅照相机 DT_CHARSTREAM 字符流 DT_METAFILE 图元文件 DT_DISPFILE 显示器文件 2. 如果 hdc 参数是增强型图元文件的设备环境句柄，则设备技术就是给 CreateEnhMetaFile 函数的引用设备，使用 GetObjectType 函数可以确定它是否增强型图元文件的设备环境。
HORZSIZE	物理显示器的宽度（毫米）
VERTSIZE	物理显示器的高度（毫米）
HORZRES	物理显示器的宽度（像素）
VERTRES	物理显示器的高度（像素）
LOGPIXELSX	1. 沿显示器宽度每逻辑英寸的像素数 2. 在多显示器系统中，该值对所显示器相同
LOGPIXELSY	1. 沿显示器高度每逻辑英寸的像素数 2. 在多显示器系统中，该值对所显示器相同
BITSPIXEL	每个像素的色彩位数
PLANES	色彩平面的数目
NUMBRUSHES	设备指定的画刷数
NUMPENS	设备指定的画笔数
NUMFONTS	设备指定的字体数
NUMCOLORS	1. 如果设备的色彩深度不超过 8位/像素点，返回设备的色彩数值 2. 如果设备的色彩深度超过 8位/像素点，返回 1
ASPECTX	用于画线的设备像素的相对宽度
ASPECTY	用于画线的设备像素的相对高度
ASPECTXY	用于画线的设备像素的对角线宽度
PDEVICESIZE	保留
CLIPCAPS	1. 显示设备支持剪切性能的标志 2. 如果设备可剪切为一个矩形，则为 1，否则为 0
SIZEPALETTE	1. 系统调色板中的入口数目 2. 只有当设备驱动器在 RASTERCAPS 索引中设置 RC_PALETFE 标志时该索引值才是有效的 3. 该索引值只能用于 16 位 Windows 的驱动器
NUMRESERVED	1. 系统调色板中保留的入口数目 2. 只有当设备驱动器在 RASTERLAP 索引中设置 RC_PALETFE 标志时该索引值才是有效的 3. 该索引值只能用于 16 位 Windows 的驱动器
COLORRES	1. 设备的实际颜色分辨率（位/像素） 2. 只有当设备驱动器在 RASTERLAP 索引中设置 RC_PALETFE 标志时该索引值才是有效的 3. 该索引值只能用于 16 位 Windows 的驱动器
PHYSICALWIDTH	对于打印设备：设备单位的物理页面的宽度。例如一个在 8.5 * 11 纸上设置为 600dpi 的打印机的设备物理单位宽度值为 5100，注意物理页面总是大于可打印的页面面积
PHYSICALHEIGHT	对于打印设备：设备单位的物理页面的高度。例如一个在 8.5 * 11 纸上设置为 600dpi 的打印机的设备物理单位高度值为 6600，注意物理页面总是大于可打印的页面面积
PHYSICALOFFSETX	对于打印设备：从物理页面左边到打印页面左边的距离。例如一个在 8.5 * 11 纸上设置为 600dpi 的打印机，不能在超出左边 0.25 英寸的地方打印，且有一个 150 设备单位的水平物理位移
PHYSICALOFFSETY	对于打印设备：从物理页面上面到打印页面上边的距离。例如一个在 8.5 * 11 纸上设置为 600dpi 的打印机，不能在超出上边 0.5 英寸的地方打印，且有一个 300 设备单位的垂直物理位移
VREFRESH	对于显示设备： 1. 设备的当前垂直刷新率（循环次数/秒，Hz） 2. 0 或 1 代表显示硬件的默认刷新率，此默认刷新率通常通过设置显卡或主板的跳线来改变，或通过一个非显示函数（比如 ChangeDisplaySettings） 的配置程序来设置
SCALINGFACTORX	打印机 x 轴的比例系数
SCALINGFACTORY	打印机 y 轴的比例系数
BLTALIGNMENT	1. 首选的水平绘图调整（表示为像素的倍数） 2. 对于最佳性能的绘图操作，窗口水平绘图应该是调整到此值的倍数
SHADEBLENDCAPS	该值用于指定显示设备的阴影和混合性能： SB_CONST_ALPHA 处理 BLENDFUNCTION 结构中的 SourceConstantAlpha 元素，并通过 AlphaBlend 函数中的 blendFunction 参数来指定 SB_GRAD_RECT 调用 GradientFill 函数填充矩形 SB_GRAD_TRI 调用 GradientFill 函数填充三角形 SB_NONE 设备不支持这些特性 SB_PIXEL_ALPHA 调用 AlphaBlend 函数处理每一个像素 Alpha SB_PREMULT_ALPHA 调用 AlphaBlend 函数对 Alpha 进行预乘
RASTERCAPS	该值用于指定显示设备的光栅性能： RC_BANDING 需要联合支持 RC_BITBLT 支持传送位图 RC_BITMAP64 支持大于 64K 的位图 RC_DI_BITMAP 支持 SetDIBits 函数和 GetDIBits 函数 RC_DIBTODEV 支持 SetDIBitsToDevice 函数 RC_FLOODFILL 支持连续填充 RC_PALETTE 指定一个基于调色板的设备 RC_SCALING 支持缩放 RC_STRETCHBLT 支持 StretchBlt 函数 RC_STRETCHDIB 支持 StretchDIBits 函数
CURVECAPS	该值用于指定显示设备绘制曲线的性能： CC_NONE 不支持绘制曲线 CC_CHORD 支持绘制弦 CC_CIRCLES 支持绘制圆 CC_ELLIPSES 支持绘制椭圆 CC_INTERIORS 支持内部填充 CC_PIE 支持绘制扇形图 CC_ROUNDRECT 支持绘制圆角矩形 CC_STYLED 支持绘制带风格的边界 CC_WIDE 支持绘制宽的边界 CC_WIDESTYLED 支持绘制宽且带风格的边界
LINECAPS	该值用于指定显示设备绘制线段的性能： LC_NONE 不支持绘制线段 LC_INTERIORS 支持内部填充 LC_MARKER 支持绘制标记符 LC_POLYLINE 支持折线 LC_POLYMARKER 支持多种标记符 LC_STYLED 支持带风格的线段 LC_WIDE 支持画宽线 LC_WIDESTYLED 支持画宽的且带风格的线段
POLYGONALCAPS	该值用于指定显示设备绘制多边形的性能： PC_NONE 不支持绘制多边形 PC_INTERIORS 支持内部填充 PC_POLYGON 支持绘制间隔式填充多边形 PC_RECTANGLE 支持绘制矩形 PC_SCANLINE 支持绘制扫描线 PC_STYLED 支持绘制带风格的边界 PC_WIDE 支持绘制宽边界 PC_WIDESTYLED 支持绘制宽的且带风格的边界 PC_WINDPOLYGON 支持绘制折线式填充多边形
TEXTCAPS	该值用于指定显示设备绘制文本的性能： TC_OP_CHARACTER 支持字符输出精度 TC_OP_STROKE 支持笔画输出精度 TC_CP_STROKE 支持笔画剪切精度 TC_CR_90 支持字符作 90 度旋转 TC_CR_ANY 支持字符作任意角度旋转 TC_SF_X_YINDEP 支持 x 和 y 方向的独立缩放 TC_SA_DOUBLE 支持把字符放大一倍 TC_SA_INTEGER 支持整数倍缩放 TC_SA_CONTIN 支持以任何倍数的严格缩放 TC_EA_DOUBLE 支持字符加重 TC_IA_ABLE 支持斜字体 TC_UA_ABLE 支持下划线 TC_SO_ABLE 支持删除线 TC_RA_ABLE 支持光栅字体 TC_VA_ABLE 支持矢量字体 TC_RESERVED 保留，但必须为 0 TC_SCROLLBLT 不支持用位快传递来滚动（注意，这可能事与愿违）
COLORMGMTCAPS	该值用于指定显示设备颜色管理的性能： CM_CMYK_COLOR 设备可以接受 CMYK 色彩空间的 ICC 色彩配置文件 CM_DEVICE_ICM 设备可以在任意的设备驱动程序或设备本身执行的 ICM CM_GAMMA_RAMP 设备支持 GetDeviceGammaRamp 函数和 SetDeviceGammaRamp 函数 CM_NONE 设备不支持 ICM

返回值：

1. 返回 nIndex 参数指定项的值；

2. 如果 nIndex 参数是 BITSPIXEL， 且设备是具有 15bpp 或 16bpp，返回值是 16。


备注：

1. 如果 nIndex 参数的值是 SHADEBLENDCAPS：

• 对于打印设备：GetDeviceCaps 函数返回任何打印机的报告
• 对于显示设备：所有混合操作都支持，除了 SB_NONE，唯一的返回值是 SB_CONST_ALPHA 和 SB_PIXEL_ALPHA，这表明这些操作是否被加速
  

2. 在多显示器系统中，如果 hdc 是台式机，GetDeviceCaps 函数返回主显示器的功能。如果你想为其他显示器的信息，则必须使用多显示器的 API 函数或调用 CreateDC 函数得到一个 hdc 指定显示器的设备环境。

注意，一般显示 1 是主显示器，但并非总是如此。

3. GetDeviceCaps 提供了以下六个索引值为打印设备转义符：

索引值	打印设备转义符
PHYSICALWIDTH	GETPHYSPAGESIZE
PHYSICALHEIGHT	GETPHYSPAGESIZE
PHYSICALOFFSETX	GETPRINTINGOFFSET
PHYSICALOFFSETY	GETPHYSICALOFFSET
SCALINGFACTORX	GETSCALINGFACTOR
SCALINGFACTORY	GETSCALINGFACTOR

4. 注意：

• GetDeviceCaps 函数获得的信息来源于显示驱动程序。
• 如果显示驱动程序拒绝提供任何信息，GetDeviceCaps 函数则通过计算固定数据得到信息。
• 如果显示驱动程序报告无效信息，GetDeviceCaps 函数返回无效信息。
• 此外，如果显示驱动拒绝报告信息，GetDeviceCaps 函数可能计算不正确的信息，因为它假设是固定的 DPI（每英寸点数 96）或固定的大小（取决于显示驱动程序是否提供）。
• 不幸的是，实现在 Windows 显示驱动程序模型（WDDM）（在 Windows Vista 中引入）的显示驱动程序导致 GDI 拿不到信息，所以 GetDeviceCaps 函数必须通过计算得到信息。
  

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。

雪夜传说01

good
非常好，中文的