PAGP_COMMIT_PHYSICAL função de retorno de chamada (videoagp.h)
A função AgpCommitPhysical mapeia a memória do sistema (físico) para o intervalo especificado de endereços físicos decodificação 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 miniporta.
[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 a PhysicalReserveContext.
Retornar valor
AgpCommitPhysical retornaráTRUE se o mapeamento tiver sido bem-sucedido e FALSE caso contrário.
Comentários
Um driver de miniporta 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, Pages e Offset incluir quaisquer páginas confirmadas anteriormente, AgpCommitPhysical poderá falhar.
Os drivers de miniporta 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, o 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ísicos identificado por PhysicalReserveContext é mapeada para páginas bloqueadas de memória física. A parte mapeada inicia páginas offset no intervalo identificado por PhysicalReserveContext. O driver de miniporto de vídeo pode acessar a memória física confirmada como se fosse contígua.
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 |