PAGP_RESERVE_VIRTUAL função de retorno de chamada (videoagp.h)
A função AgpReserveVirtual reserva um intervalo de endereços virtuais para a AGP.
Sintaxe
PAGP_RESERVE_VIRTUAL PagpReserveVirtual;
PVOID PagpReserveVirtual(
[in] IN PVOID HwDeviceExtension,
[in] IN HANDLE ProcessHandle,
[in] IN PVOID PhysicalReserveContext,
[out] OUT PVOID *VirtualReserveContext
)
{...}
Parâmetros
[in] HwDeviceExtension
Ponteiro para a extensão do dispositivo do driver de miniport.
[in] ProcessHandle
Manipular o processo no qual reservar o intervalo de endereços virtuais. Se ProcessHandle for 0, o intervalo de endereços virtuais será alocado no espaço do sistema.
[in] PhysicalReserveContext
É o identificador de contexto que identifica o intervalo de endereços físicos reservado ao qual associar a reserva de memória virtual. Esse contexto foi obtido de AgpReservePhysical.
[out] VirtualReserveContext
É o local em que o driver de porta de vídeo grava um identificador de contexto que identifica a memória virtual reservada.
Valor de retorno
AgpReserveVirtual retornará o endereço base do intervalo de endereços virtuais reservado, se bem-sucedido; caso contrário, retorna NULL.
Observações
Se ProcessHandle não for 0, reservas de AgpReserveVirtual, mas não confirmar, um intervalo de endereços virtuais no espaço de endereço de um processo de modo de usuário. Nesse caso, você deve chamar AgpCommitVirtual para mapear os endereços virtuais reservados (modo de usuário) para endereços físicos.
Se ProcessHandle for 0, AgpReserveVirtual alocará um intervalo de endereços virtuais no espaço do sistema e mapeará automaticamente (confirma) todo o intervalo de endereços virtuais para endereços físicos. Embora AgpReserveVirtual confirme todo o intervalo virtual, você ainda deve chamar AgpCommitVirtual antes que qualquer código acesse o intervalo virtual.
Quando você chama AgpReserveVirtual para alocar um intervalo de endereços virtuais no espaço do sistema (ou seja, se você definir ProcessHandle como 0), todo o intervalo de endereços físicos identificados por PhysicalReserveContext deverá ser confirmado em páginas bloqueadas de memória física por uma chamada anterior para AgpCommitPhysical.
O driver de miniporto pode chamar AgpReleaseVirtual várias vezes para reservar muitos intervalos de endereços menores em vez de um grande intervalo.
O driver de miniporto deve chamar AgpReleaseVirtual para liberar o intervalo de endereços virtuais reservado quando ele não for mais necessário.
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 |