функция обратного вызова DXGKCB_AGP_ALLOCATE_POOL (dispmprt.h)

  • Статья

Функция обратного вызова DXGKCB_AGP_ALLOCATE_POOL резервирует, фиксирует и сопоставляет память ускоренного графического порта (AGP).

Синтаксис

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
)
{...}

Параметры

[in] Context

Дескриптор для блока контекста, связанного с интерфейсом AGP. Драйвер мини-порта дисплея ранее получал этот дескриптор в элементе Context структуры DXGK_AGP_INTERFACE, которая была заполнена DxgkCbQueryServices.

[in] AllocationSize

Размер выделенной памяти AGP (в байтах).

[in] CacheType

Константу из перечисления MEMORY_CACHING_TYPE , указывающую, может ли ЦП использовать кэширование или объединение операций записи при обращении к выделенной памяти AGP.

[out] PhysicalAddress

Указатель на структуру PHYSICAL_ADDRESS, получающую базовый физический адрес выделения AGP. Это основа диапазона физических адресов, который GPU будет использовать для доступа к памяти AGP.

[out] VirtualAddress

Указатель на переменную, которая получает базовый виртуальный адрес в системном пространстве выделения AGP. Это основа диапазона виртуальных адресов, который ЦП будет использовать для доступа к памяти AGP.

Возвращаемое значение

AgpAllocatePool возвращает STATUS_SUCCESS в случае успешного выполнения. В противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.

Комментарии

Вызовите AgpAllocatePool в функции DxgkDdiStartDevice драйвера минипорта дисплея. Вполне вероятно, что AgpAllocatePool завершится ошибкой , если вызвать его после выполнения DxgkDdiStartDevice .

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Персональный компьютер
Верхняя часть dispmprt.h (включая Dispmprt.h)
IRQL PASSIVE_LEVEL

См. также раздел

AgpFreePool

AgpSetCommand

DXGK_AGP_INTERFACE

DxgkCbQueryServices