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 miniporta de exibição recebeu anteriormente esse identificador no membro Context da estrutura 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 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.

Retornar valor

AgpAllocatePool retornará STATUS_SUCCESS se for bem-sucedido. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

Chame AgpAllocatePool na função DxgkDdiStartDevice do driver de miniporta de exibição. É provável que AgpAllocatePool falhe se você chamá-lo depois que DxgkDdiStartDevice for executado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Área de Trabalho
Cabeçalho	dispmprt.h (inclua Dispmprt.h)
IRQL	PASSIVE_LEVEL

Confira também

AgpFreePool

AgpSetCommand

DXGK_AGP_INTERFACE

DxgkCbQueryServices