共用方式為


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、VisScreenWidthVideoMemoryBitmapWidthScreenStride三個成員與水平螢幕寬度相關聯。 針對每個圖元使用一或多個字節的顯示,這些成員滿足不等比較
VisScreenWidth<= VideoMemoryBitmapWidth<= ScreenStride
在垂直螢幕高度的類似關聯性中,VisScreenHeightVideoMemoryBitmapHeight 滿足不平等
VisScreenHeight<= VideoMemoryBitmapHeight

要求

要求 價值
標頭 ntddvdeo.h (include Ntddvdeo.h)

另請參閱

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION