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

  • Статья

Функция DxgkDdiDescribeAllocation извлекает сведения о существующем выделении, недоступные подсистеме графического ядра Microsoft DirectX.

Синтаксис

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

NTSTATUS DxgkddiDescribeallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}

Параметры

[in] hAdapter

Дескриптор для блока контекста, связанного с видеоадаптером. Драйвер мини-порта дисплея ранее предоставлял этот дескриптор подсистеме ядра графики DirectX в выходном параметре MiniportDeviceContext функции DxgkDdiAddDevice .

[in/out] pDescribeAllocation

Указатель на структуру DXGKARG_DESCRIBEALLOCATION , описывающую существующее выделение.

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

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

Комментарии

Так как подсистема графического ядра DirectX не обязательно поддерживает записи о выделении, подсистема графического ядра вызывает DxgkDdiDescribeAllocation , чтобы запросить, чтобы драйвер мини-порта отображения возвращал сведения о существующих выделениях. В настоящее время драйвер мини-порта дисплея должен иметь возможность возвращать эти сведения для следующих выделений:

  • Выделения, которые также являются первичными (то есть выделения, созданные драйвером отображения пользовательского режима, установив флаг основного битового поля в элементе Flagsструктуры D3DDDI_ALLOCATIONINFO при вызове функции pfnAllocateCb ).
  • Выделения, которые могут быть источником презентации (то есть выделения, представленные элементом hSourceструктуры DXGKARG_PRESENT при вызове функции DxgkDdiPresent драйвера мини-порта дисплея).
DxgkDdiDescribeAllocation следует сделать страничной.

Требования

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

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

D3DDDI_ALLOCATIONINFO

DXGKARG_DESCRIBEALLOCATION

DxgkDdiAddDevice

DxgkDdiPresent

pfnAllocateCb