estrutura VIDEO_MEMORY_INFORMATION (ntddvdeo.h)

Artigo
02/26/2024

A estrutura VIDEO_MEMORY_INFORMATION contém informações sobre um mapeamento de memória de vídeo para o espaço do sistema ou o espaço de endereço virtual privado de um processo de modo de usuário. O mapeamento é criado quando uma solicitação de IOCTL_VIDEO_MAP_VIDEO_MEMORY é enviada para o driver de miniporto de vídeo.

Sintaxe

typedef struct _VIDEO_MEMORY_INFORMATION {
  PVOID VideoRamBase;
  ULONG VideoRamLength;
  PVOID FrameBufferBase;
  ULONG FrameBufferLength;
} VIDEO_MEMORY_INFORMATION, *PVIDEO_MEMORY_INFORMATION;

Membros

VideoRamBase

Endereço virtual da RAM de vídeo no espaço do sistema ou no espaço de endereço do processo de modo de usuário que iniciou a solicitação.

VideoRamLength

O tamanho, em bytes, do intervalo de endereços virtuais mapeado para a RAM de vídeo. A memória acessível por meio de um mecanismo de comutador bancário não é descrita por esse valor.

Esse valor deve ser igual ao produto VideoMemoryBitmapHeight * ScreenStride, em que cada fator no produto é um membro da estrutura VIDEO_MODE_INFORMATION .

FrameBufferBase

Ponteiro para o endereço virtual do buffer de quadro no espaço de endereço do chamador. O buffer de quadro é a parte exibida ativamente da RAM de vídeo.

FrameBufferLength

Especifica o comprimento linear do buffer de quadro no espaço de endereço virtual do chamador. A memória acessível por meio de um mecanismo de comutador bancário não é descrita por esse valor.

Esse valor deve ser igual ao produto VisScreenWidth * ScreenStride, em que cada termo neste produto é um membro da estrutura VIDEO_MODE_INFORMATION .

Comentários

Na solicitação IOCTL_VIDEO_MAP_VIDEO_MEMORY , VIDEO_MEMORY serve como uma estrutura de entrada, enquanto VIDEO_MEMORY_INFORMATION serve como uma estrutura de saída.