функция обратного вызова 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 драйвера мини-порта дисплея).
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista |
Целевая платформа | Персональный компьютер |
Верхняя часть | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |