Compartilhar via

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

  • Artigo

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 miniporta'.

[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 identificado por VirtualReserveContext.

Retornar valor

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

Comentários

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 miniporta 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, o 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 inicia páginas offset no intervalo de endereços virtuais identificado por VirtualReserveContext.

Requisitos

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

Confira também

AgpFreeVirtual

AgpReservePhysical

AgpReserveVirtual