PAGP_COMMIT_PHYSICAL função de retorno de chamada (videoagp.h)
A memória do sistema de mapas de função AgpCommitPhysical (física) para o intervalo especificado de endereços físicos decodificadas pelo AGP.
Sintaxe
PAGP_COMMIT_PHYSICAL PagpCommitPhysical;
BOOLEAN PagpCommitPhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID PhysicalReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
Parâmetros
[in] HwDeviceExtension
Ponteiro para a extensão do dispositivo do driver de miniporto.
[in] PhysicalReserveContext
Identifica um intervalo de endereços físicos reservado. O identificador de contexto é obtido de AgpReservePhysical .
[in] Pages
Especifica o número de páginas de memória do sistema a serem confirmadas.
[in] Offset
Especifica o deslocamento de página no qual as páginas são confirmadas. O deslocamento é aplicado ao intervalo de endereços físicos reservado associado ao PhysicalReserveContext.
Valor de retorno
AgpCommitPhysical retornará verdadeiro se o mapeamento tiver sido bem-sucedido e FALSE caso contrário.
Observações
Um driver de miniporto de vídeo deve primeiro reservar endereços físicos chamando AgpReservePhysical antes de chamar essa função.
Não chame AgpCommitPhysical para confirmar endereços que já foram confirmados. Se o intervalo de páginas especificado por PhysicalReserveContext, Pagese Offset incluir quaisquer páginas confirmadas anteriormente, AgpCommitPhysical poderá falhar.
Os drivers de miniporto de vídeo executados no Microsoft Windows 2000 devem sempre reservar e confirmar um intervalo físico cujo tamanho é um múltiplo de 64 quilobytes. Reservar ou confirmar um intervalo físico que não seja um múltiplo de 64 quilobytes pode resultar em AgpReserveVirtual ou AgpCommitVirtual retornando um endereço virtual inválido.
No Windows XP e posterior, AgpCommitPhysical expande automaticamente o intervalo confirmado para que ele seja um múltiplo de 64 quilobytes.
Quando um driver de miniporto de vídeo chama AgpCommitPhysical, uma parte do intervalo de endereços físico identificado por PhysicalReserveContext é mapeada para páginas bloqueadas de memória física. A parte mapeada começa páginas de deslocamento no intervalo identificado por PhysicalReserveContext. O driver do miniporto de vídeo pode acessar a memória física confirmada como se fosse contígua.
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 |