Compartilhar via


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 miniporto 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 de 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 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.

de nome do sinalizador de valor do sinalizador número de bits valor de bit e de significado
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 de
VIDEO_MODE_MANAGED_PALETTE 0x0008 3 0 = A paleta é fixa (deve ser consultada do driver de miniporto)
1 = 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 offscreen 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 em buffer de quadro são tratadas corretamente
1 = Gravações de memória de 64 bits no buffer de quadro 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 miniporto e são usados apenas pelo miniporto e pelos drivers de exibição.

Observações

O driver do miniporto de vídeo retorna uma matriz de estruturas de VIDEO_MODE_INFORMATION em resposta a uma solicitação IOCTL_VIDEO_QUERY_AVAIL_MODES, com cada estrutura contendo informações sobre um modo do adaptador. O driver de miniporto 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 do 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
ScreenStride doVideoMemoryBitmapWidth .
Em uma relação semelhante para a altura da tela vertical, VisScreenHeight e VideoMemoryBitmapHeight satisfazer a desigualdade
VideoMemoryBitmapHeight do VisScreenHeight.

Requisitos

Requisito Valor
cabeçalho ntddvdeo.h (inclua Ntddvdeo.h)

Consulte também

IOCTL_VIDEO_QUERY_AVAIL_MODES

IOCTL_VIDEO_QUERY_CURRENT_MODE

VIDEO_MEMORY_INFORMATION