DXGKCB_AGP_ALLOCATE_POOL função de retorno de chamada (dispmprt.h)
A função de retorno de chamada DXGKCB_AGP_ALLOCATE_POOL reserva, confirma e mapeia a memória da AGP (Porta Gráfica Acelerada).
Sintaxe
DXGKCB_AGP_ALLOCATE_POOL DxgkcbAgpAllocatePool;
NTSTATUS DxgkcbAgpAllocatePool(
[in] IN HANDLE Context,
[in] IN ULONG AllocationSize,
[in] IN MEMORY_CACHING_TYPE CacheType,
[out] OUT PPHYSICAL_ADDRESS PhysicalAddress,
[out] OUT PVOID *VirtualAddress
)
{...}
Parâmetros
[in] Context
Um identificador para um bloco de contexto associado a uma interface AGP. O driver de miniporto de exibição recebeu anteriormente esse identificador no Context membro da estrutura de DXGK_AGP_INTERFACE que foi preenchida por DxgkCbQueryServices.
[in] AllocationSize
O tamanho, em bytes, da memória AGP a ser alocada.
[in] CacheType
Uma constante da enumeração MEMORY_CACHING_TYPE que especifica se a CPU pode usar o cache ou a combinação de gravação quando acessa a memória AGP alocada.
[out] PhysicalAddress
Um ponteiro para uma estrutura de PHYSICAL_ADDRESS que recebe o endereço físico base da alocação do AGP. Essa é a base do intervalo de endereços físicos que a GPU usará para acessar a memória do AGP.
[out] VirtualAddress
Um ponteiro para uma variável que recebe o endereço virtual base, no espaço do sistema, da alocação do AGP. Essa é a base do intervalo de endereços virtuais que a CPU usará para acessar a memória do AGP.
Valor de retorno
AgpAllocatePool retornará STATUS_SUCCESS se tiver êxito. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.
Observações
Chame AgpAllocatePool na função de DxgkDdiStartDevice do driver de miniport de exibição. É provável que AgpAllocatePool falhará se você chamá-lo depois que DxgkDdiStartDevice tiver sido executado.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |