estrutura VIDEO_MODE_INFORMATION (ntddvdeo.h)

A estrutura VIDEO_MODE_INFORMATION contém todas as informações sobre um modo de um adaptador de vídeo.

Sintaxe

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;

Membros

Length

Especifica o comprimento, em bytes, dessa estrutura. Um driver de miniporta pode usar esse valor para determinar a versão dessa estrutura.

ModeIndex

Especifica o índice do modo específico a ser usado em uma chamada para o driver de miniporto.

VisScreenWidth

Especifica o número de pixels visíveis em uma linha de verificação horizontal.

VisScreenHeight

Especifica o número de linhas visíveis (ou linhas de verificação) na tela.

ScreenStride

Especifica o número de bytes entre o início de uma linha de verificação e a próxima.

NumberOfPlanes

Especifica o número de planos separados combinados pelo dispositivo.

BitsPerPlane

Especifica o número de bits por pixel por plano.

Frequency

Especifica a taxa de atualização da tela, em Hertz.

XMillimeter

Especifica a largura, em milímetros, da região ativa no dispositivo de saída.

YMillimeter

Especifica a altura, em milímetros, da região ativa no dispositivo de saída.

NumberRedBits

Especifica o número de bits no DAC vermelho.

NumberGreenBits

Especifica o número de bits no DAC verde.

NumberBlueBits

Especifica o número de bits no DAC azul.

RedMask

É a máscara de cores vermelha para um dispositivo com modos de cor diretos. Por exemplo, para indicar que os bits 0 a 4 devem ser usados para vermelho, use o valor 0x001F.

GreenMask

É a máscara de cor verde para um dispositivo com modos de cor diretos. Por exemplo, para indicar que os bits 5 a 9 devem ser usados para verde, use o valor 0x03E0.

BlueMask

É a máscara de cores azul para um dispositivo com modos de cor diretos. Por exemplo, para indicar que os bits de 10 a 14 devem ser usados para azul, use o valor 0x7C00.

AttributeFlags

É um conjunto de sinalizadores que indica determinado comportamento para o dispositivo. Os sinalizadores e seus significados são mostrados na tabela a seguir.

Nome do Sinalizador	Valor do sinalizador	Número do Bit	Valor e significado do bit
VIDEO_MODE_COLOR	0x0001	0	0 = Compatível com Mono 1 = Cor
VIDEO_MODE_GRAPHICS	0x0002	1	0 = Modo de texto 1 = Gráficos
VIDEO_MODE_PALETTE_DRIVEN	0x0004	2	0 = As cores são diretas 1 = As cores são indexadas a uma paleta
VIDEO_MODE_MANAGED_PALETTE	0x0008	3	0 = A paleta é fixa (deve ser consultada do driver de miniporta) 1 = A paleta é configurável
VIDEO_MODE_INTERLACED	0x0010	4	0 = Modo não entrelaçado 1 = Modo entrelaçado
VIDEO_MODE_NO_OFF_SCREEN	0x0020	5	0 = A memória fora da tela está disponível 1 = A memória fora da tela não pode ser usada para armazenar informações
VIDEO_MODE_NO_64_BIT_ACCESS	0x0040	6	0 = Gravações de memória de 64 bits no buffer de quadros são tratadas corretamente 1 = As gravações de memória de 64 bits no buffer de quadros não são tratadas

VideoMemoryBitmapWidth

Especifica a largura, em pixels, do bitmap de memória de vídeo.

VideoMemoryBitmapHeight

Especifica a altura, em pixels, do bitmap de memória de vídeo.

DriverSpecificAttributeFlags

É um conjunto de sinalizadores que indica determinado comportamento para o dispositivo. Esses sinalizadores privados são definidos no driver de miniporta e são usados apenas pelos drivers de miniporto e de exibição.

Comentários

O driver de miniporto de vídeo retorna uma matriz de estruturas VIDEO_MODE_INFORMATION em resposta a uma solicitação de IOCTL_VIDEO_QUERY_AVAIL_MODES , com cada estrutura contendo informações sobre um modo do adaptador. O driver de miniporta retorna uma estrutura VIDEO_MODE_INFORMATION que contém informações sobre o modo atual do adaptador em resposta a uma solicitação de IOCTL_VIDEO_QUERY_CURRENT_MODE .

Três membros de VIDEO_MODE_INFORMATION, VisScreenWidth, VideoMemoryBitmapWidth e ScreenStride, estão associados à largura horizontal da tela. Para exibições que usam um ou mais bytes por pixel, esses membros atendem à desigualdade

VisScreenWidth<= VideoMemoryBitmapWidth<= ScreenStride.

Em uma relação semelhante para a altura vertical da tela, VisScreenHeight e VideoMemoryBitmapHeight atendem à desigualdade

VisScreenHeight<= VideoMemoryBitmapHeight.

Requisitos

Requisito	Valor
Cabeçalho	ntddvdeo.h (include Ntddvdeo.h)

Confira também

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION