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 do VideoMemoryBitmapWidth .
- 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) |