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.
| Attributname | Attributwert | Bitnummer | Bitwert und Bedeutung |
|---|---|---|---|
| VIDEO_MODE_COLOR | 0x0001 | 0 | 0 = Monokompatibel 1 = Farbe |
| VIDEO_MODE_GRAPHICS | 0x0002 | 1 | 0 = Textmodus 1 = Grafiken |
| VIDEO_MODE_PALETTE_DRIVEN | 0x0004 | 2 | 0 = Farben sind direkt 1 = Farben werden in eine Palette indiziert. |
| VIDEO_MODE_MANAGED_PALETTE | 0x0008 | 3 | 0 = Palette ist fest (muss vom Miniporttreiber abgefragt werden) 1 = Palette ist festgelegt |
| VIDEO_MODE_INTERLACED | 0x0010 | 4 | 0 = Nicht-Interlaced-Modus 1 = Interlaced Mode |
| VIDEO_MODE_NO_OFF_SCREEN | 0x0020 | 5 | 0 = Offscreen-Speicher ist verfügbar 1 = Offscreen-Speicher kann nicht zum Speichern von Informationen verwendet werden |
| VIDEO_MODE_NO_64_BIT_ACCESS | 0x0040 | 6 | 0 = 64-Bit-Speicherschreibvorgänge in Framepuffer ordnungsgemäß behandelt werden 1 = 64-Bit-Speicherschreibvorgänge in Framepuffer werden nicht behandelt. |
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
| Anforderung | Wert |
|---|---|
| Header- | ntddvdeo.h (enthalten Ntddvdeo.h) |