PAGP_COMMIT_VIRTUAL função de retorno de chamada (videoagp.h)

Artigo
02/07/2025

A função AgpCommitVirtual mapeia a memória virtual reservada para um intervalo associado de endereços físicos decodificação de AGP.

Sintaxe

PAGP_COMMIT_VIRTUAL PagpCommitVirtual;

PVOID PagpCommitVirtual(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID VirtualReserveContext,
  [in] IN ULONG Pages,
  [in] IN ULONG Offset
)
{...}

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão do dispositivo do driver de miniporto'.

[in] VirtualReserveContext

Identifica um intervalo de endereços virtuais reservado. O identificador de contexto foi obtido de AgpReserveVirtual.

[in] Pages

Especifica o número de páginas de memória virtual a serem mapeadas.

[in] Offset

Especifica o deslocamento de página no qual as páginas são confirmadas. O deslocamento é aplicado ao intervalo de endereços virtuais reservado que é identificado por VirtualReserveContext.

Valor de retorno

AgpCommitVirtual retornará o endereço virtual da base das páginas confirmadas se o mapeamento tiver sido bem-sucedido; caso contrário, retornará NULL.

Observações

Antes de chamar AgpCommitVirtual para confirmar um intervalo de páginas virtuais, você deve fazer o seguinte:

Chame AgpReservePhysical para reservar um intervalo de endereços físicos para a GPU usar.
Chame AgpCommitPhysical para mapear uma parte (ou todos) dos endereços físicos reservados para páginas bloqueadas na memória do sistema.
Chame AgpReserveVirtual para reservar um intervalo de endereços virtuais associados ao intervalo de endereços físicos reservados por AgpReservePhysical.

Depois que esses itens forem concluídos, você poderá chamar AgpCommitVirtual para mapear uma parte das páginas virtuais reservadas para páginas que já foram mapeadas e bloqueadas por AgpCommitPhysical. Você não deve tentar mapear uma página de endereços virtuais se a página correspondente de endereços físicos ainda não tiver sido mapeada.

Os drivers de miniporto de vídeo executados no Microsoft Windows 2000 sempre devem confirmar um intervalo virtual cujo tamanho é um múltiplo de 64 quilobytes. Se você chamar AgpCommitVirtual para confirmar um intervalo virtual que não seja um múltiplo de 64 quilobytes, ele poderá retornar um endereço virtual inválido.

No Windows XP e posterior, AgpCommitVirtual expande automaticamente o intervalo confirmado para que ele seja um múltiplo de 64 quilobytes.

Quando um driver de miniporto chama AgpCommitVirtual, uma parte do intervalo de endereços virtual identificado por VirtualReserveContext é mapeada para endereços físicos. A parte mapeada começa páginas de deslocamento no intervalo de endereços virtual identificado por VirtualReserveContext.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	videoagp.h (inclua Video.h)
IRQL	PASSIVE_LEVEL

Consulte também

AgpFreeVirtual

AgpReservePhysical

AgpReserveVirtual

Partilhar via