PAGP_RESERVE_PHYSICAL função de retorno de chamada (videoagp.h)
A função AgpReservePhysical reserva um intervalo de endereços físicos no barramento do sistema para o qual o controlador AGP pode responder.
Sintaxe
PAGP_RESERVE_PHYSICAL PagpReservePhysical;
PHYSICAL_ADDRESS PagpReservePhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG Pages,
[in] IN VIDEO_PORT_CACHE_TYPE Caching,
[out] OUT PVOID *PhysicalReserveContext
)
{...}
Parâmetros
[in] HwDeviceExtension
Ponteiro para a extensão do dispositivo do driver de miniport.
[in] Pages
Especifica o número de páginas que o driver de porta de vídeo deve reservar.
[in] Caching
Uma enumeração VIDEO_PORT_CACHE_TYPE que especifica o tipo de cache que o sistema deve usar.
[out] PhysicalReserveContext
Especifica o local no qual o driver da porta de vídeo grava um identificador de contexto que identifica o espaço de endereço físico reservado.
Valor de retorno
AgpReservePhysical retornará o endereço base do intervalo de endereços físicos reservado, se bem-sucedido; caso contrário, ele retorna NULL.
Observações
Os drivers de miniporto de vídeo executados no Windows 2000 devem sempre reservar um intervalo cujo tamanho é um múltiplo de 64 quilobytes. Reservar um intervalo 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, AgpReservePhysical expande automaticamente o intervalo solicitado para um múltiplo de 64 quilobytes.
Após o retorno bem-sucedido, o controlador AGP pode responder ao intervalo de endereços físicos reservado no barramento. No entanto, o driver de miniporto de vídeo deve primeiro chamar AgpCommitPhysical para fazer com que essa memória seja confirmada antes de acessá-la para que os resultados acessados sejam definidos.
O driver de miniporto pode chamar AgpReservePhysical várias vezes para reservar muitos intervalos de endereços menores em vez de um grande intervalo.
O driver de miniporto deve chamar AgpReleasePhysical para liberar o intervalo de endereços físico quando ele não for mais necessário.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 |
| da Plataforma de Destino |
Área de trabalho |
| cabeçalho | videoagp.h (inclua Video.h) |
| IRQL | PASSIVE_LEVEL |