VIDEO_MODE_INFORMATION Struktur (ntddvdeo.h)

Die VIDEO_MODE_INFORMATION-Struktur enthält alle Informationen zu einem Modus eines Grafikkarten.

Syntax

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;

Angehörige

Length

Gibt die Länge dieser Struktur in Bytes an. Ein Miniporttreiber kann diesen Wert verwenden, um die Version dieser Struktur zu bestimmen.

ModeIndex

Gibt den Index des bestimmten Modus an, der in einem Aufruf des Miniporttreibers verwendet werden soll.

VisScreenWidth

Gibt die Anzahl der sichtbaren Pixel in einer horizontalen Scanlinie an.

VisScreenHeight

Gibt die Anzahl der sichtbaren Zeilen (oder Scanlinien) auf dem Bildschirm an.

ScreenStride

Gibt die Anzahl der Bytes zwischen dem Anfang einer Scanzeile und der nächsten an.

NumberOfPlanes

Gibt die Anzahl von separaten Ebenen an, die vom Gerät kombiniert werden.

BitsPerPlane

Gibt die Anzahl der Bits pro Pixel pro Ebene an.

Frequency

Gibt die Bildschirmaktualisierungsrate in Hertz an.

XMillimeter

Gibt die Breite des aktiven Bereichs auf dem Ausgabegerät in Millimeter an.

YMillimeter

Gibt die Höhe des aktiven Bereichs auf dem Ausgabegerät in Millimeter an.

NumberRedBits

Gibt die Anzahl der Bits im roten DAC an.

NumberGreenBits

Gibt die Anzahl der Bits im grünen DAC an.

NumberBlueBits

Gibt die Anzahl der Bits im blauen DAC an.

RedMask

Ist die rote Farbmaske für ein Gerät mit direkten Farbmodi. Um beispielsweise anzugeben, dass Bits 0 bis 4 für Rot verwendet werden sollen, verwenden Sie den Wert 0x001F.

GreenMask

Ist die grüne Farbmaske für ein Gerät mit direkten Farbmodi. Um beispielsweise anzugeben, dass Bits 5 bis 9 für Grün verwendet werden sollen, verwenden Sie den Wert 0x03E0.

BlueMask

Ist die blaue Farbmaske für ein Gerät mit direkten Farbmodi. Um beispielsweise anzugeben, dass Bits 10 bis 14 für Blau verwendet werden sollen, verwenden Sie den Wert 0x7C00.

AttributeFlags

Ist eine Reihe von Flags, die bestimmtes Verhalten für das Gerät angeben. Die Kennzeichnungen und ihre Bedeutungen werden in der folgenden Tabelle angezeigt.

VideoMemoryBitmapWidth

Gibt die Breite der Videospeicherbitmap in Pixel an.

VideoMemoryBitmapHeight

Gibt die Höhe der Videospeicherbitmap in Pixel an.

DriverSpecificAttributeFlags

Ist eine Reihe von Flags, die bestimmtes Verhalten für das Gerät angeben. Diese privaten Flags sind im Miniporttreiber definiert und dienen nur der Verwendung durch miniport- und anzeigetreiber.

Bemerkungen

Der Video-Miniporttreiber gibt ein Array von VIDEO_MODE_INFORMATION Strukturen als Reaktion auf eine IOCTL_VIDEO_QUERY_AVAIL_MODES Anforderung zurück, wobei jede Struktur Informationen zu einem Modus des Adapters enthält. Der Miniporttreiber gibt eine VIDEO_MODE_INFORMATION Struktur zurück, die Informationen zum aktuellen Modus des Adapters als Reaktion auf eine IOCTL_VIDEO_QUERY_CURRENT_MODE Anforderung enthält.

Drei Elemente von VIDEO_MODE_INFORMATION, VisScreenWidth, VideoMemoryBitmapWidthund ScreenStride, sind mit horizontaler Bildschirmbreite verknüpft. Für Anzeigen, die mindestens eine Bytes pro Pixel verwenden, erfüllen diese Member die Ungleichheit.

VisScreenWidth<= VideoMemoryBitmapWidth<= ScreenStride.

In einer ähnlichen Beziehung für vertikale Bildschirmhöhe VisScreenHeight und VideoMemoryBitmapHeight die Ungleichheit erfüllen

VisScreenHeight<= VideoMemoryBitmapHeight.

Anforderungen

Siehe auch

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION