VIDEO_MODE_INFORMATION結構 (ntddvdeo.h)
VIDEO_MODE_INFORMATION結構包含一個視訊配接器模式的所有資訊。
語法
typedef struct _VIDEO_MODE_INFORMATION {
ULONG Length;
ULONG ModeIndex;
ULONG VisScreenWidth;
ULONG VisScreenHeight;
ULONG ScreenStride;
ULONG NumberOfPlanes;
ULONG BitsPerPlane;
ULONG Frequency;
ULONG XMillimeter;
ULONG YMillimeter;
ULONG NumberRedBits;
ULONG NumberGreenBits;
ULONG NumberBlueBits;
ULONG RedMask;
ULONG GreenMask;
ULONG BlueMask;
ULONG AttributeFlags;
ULONG VideoMemoryBitmapWidth;
ULONG VideoMemoryBitmapHeight;
ULONG DriverSpecificAttributeFlags;
} VIDEO_MODE_INFORMATION, *PVIDEO_MODE_INFORMATION;
成員
Length
指定這個 結構的長度,以位元組為單位。 迷你埠驅動程式可以使用此值來判斷此結構的版本。
ModeIndex
指定要用於迷你埠驅動程式呼叫中之特定模式的索引。
VisScreenWidth
指定一個水平掃描行上的可見像素數目。
VisScreenHeight
指定螢幕上可見的行數(或掃描行)。
ScreenStride
指定一個掃描行開始與下一行之間的位元元組數目。
NumberOfPlanes
指定裝置結合的個別平面數目。
BitsPerPlane
指定每一平面每個像素的位數。
Frequency
在 Hertz 中指定螢幕重新整理速率。
XMillimeter
指定輸出裝置上使用中區域的寬度,以公厘為單位。
YMillimeter
指定輸出裝置上使用中區域的高度,以公厘為單位。
NumberRedBits
指定紅色 DAC 中的位數。
NumberGreenBits
指定綠色 DAC 中的位數。
NumberBlueBits
指定藍色 DAC 中的位數目。
RedMask
這是具有直接色彩模式之裝置的紅色色彩遮罩。 例如,若要指出要用於紅色的位0到4,請使用值0x001F。
GreenMask
這是具有直接色彩模式之裝置的綠色色彩遮罩。 例如,若要指出要用於綠色的位 5 到 9,請使用值0x03E0。
BlueMask
這是具有直接色彩模式之裝置的藍色色彩遮罩。 例如,若要指出要用於藍色的位10到14,請使用值0x7C00。
AttributeFlags
這是一組旗標,指出裝置的特定行為。 下表顯示旗標及其意義。
旗標名稱 | 旗標值 | 位號碼 | 位值和意義 |
---|---|---|---|
VIDEO_MODE_COLOR | 0x0001 | 0 | 0 = Mono 相容 1 = 色彩 |
VIDEO_MODE_GRAPHICS | 0x0002 | 1 | 0 = 文字模式 1 = 圖形 |
VIDEO_MODE_PALETTE_DRIVEN | 0x0004 | 2 | 0 = 色彩是直接的 1 = 色彩會編製索引至 調色盤 |
VIDEO_MODE_MANAGED_PALETTE | 0x0008 | 3 | 0 = 調色盤是固定的(必須從迷你連接埠驅動程序查詢) 1 = 調色盤可設定 |
VIDEO_MODE_INTERLACED | 0x0010 | 4 | 0 = 非交錯模式 1 = 交錯模式 |
VIDEO_MODE_NO_OFF_SCREEN | 0x0020 | 5 | 0 = 可用的螢幕記憶體 1 = Offscreen 記憶體無法用來儲存資訊 |
VIDEO_MODE_NO_64_BIT_ACCESS | 0x0040 | 6 | 0 = 64 位記憶體寫入至 框架緩衝區 已正確處理 1 = 不會處理對框架緩衝區的 64 位記憶體寫入 |
VideoMemoryBitmapWidth
指定視訊記憶體位圖的寬度,以像素為單位。
VideoMemoryBitmapHeight
指定視訊記憶體位圖的高度,以像素為單位。
DriverSpecificAttributeFlags
這是一組旗標,指出裝置的特定行為。 這些私用旗標定義在迷你埠驅動程式中,而且僅供迷你埠和顯示驅動程式使用。
言論
視訊迷你埠驅動程式會傳回VIDEO_MODE_INFORMATION結構的數位,以回應 IOCTL_VIDEO_QUERY_AVAIL_MODES 要求,每個結構都包含一個適配卡模式的相關信息。 迷你埠驅動程式會傳回一個VIDEO_MODE_INFORMATION結構,其中包含適配卡目前模式的相關信息,以回應 IOCTL_VIDEO_QUERY_CURRENT_MODE 要求。
- VIDEO_MODE_INFORMATION、VisScreenWidth、VideoMemoryBitmapWidth和 ScreenStride三個成員與水平螢幕寬度相關聯。 針對每個圖元使用一或多個字節的顯示,這些成員滿足不等比較
- VisScreenWidth<= VideoMemoryBitmapWidth<= ScreenStride。
- 在垂直螢幕高度的類似關聯性中,VisScreenHeight 和 VideoMemoryBitmapHeight 滿足不平等
- VisScreenHeight<= VideoMemoryBitmapHeight。
要求
要求 | 價值 |
---|---|
標頭 | ntddvdeo.h (include Ntddvdeo.h) |