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

Статья
02/06/2025

Представляет изображение экрана для устройства отображения драйвера только для отображения режима отображения (KMDOD).

Синтаксис

DXGKDDI_PRESENTDISPLAYONLY DxgkddiPresentdisplayonly;

NTSTATUS DxgkddiPresentdisplayonly(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_PRESENT_DISPLAYONLY pPresentDisplayOnly
)
{...}

Параметры

hAdapter

Дескриптор контекста устройства для адаптера отображения. Функция KMDOD DxgkDdiAddDevice ранее вернула этот дескриптор в параметр е miniportDeviceContext.

pPresentDisplayOnly

Указатель на структуру DXGKARG_PRESENT_DISPLAYONLY, содержащую сведения о текущей операции.

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

Возвращает одно из следующих значений:

код возврата	описание
STATUS_SUCCESS	Текущая операция успешно завершена.
STATUS_PENDING	Текущая операция была отправлена в очередь программного обеспечения или оборудования для завершения. В этом случае KMDOD должен использовать прерывание и отложенный вызов процедуры (DPC), чтобы сообщить о ходе текущей текущей операции. В противном случае операционная система использует процесс обнаружения и восстановления времени ожидания (TDR), который сообщает об ошибке и требует, чтобы KMDOD повторно инициализировать себя и сбросить GPU. Обратите внимание, что этот код состояния не должен быть возвращен для синхронного режима, как описано в примечаниях.

код возврата

описание

STATUS_SUCCESS

Текущая операция успешно завершена.

STATUS_PENDING

Текущая операция была отправлена в очередь программного обеспечения или оборудования для завершения.
В этом случае KMDOD должен использовать прерывание и отложенный вызов процедуры (DPC), чтобы сообщить о ходе текущей текущей операции. В противном случае операционная система использует процесс обнаружения и восстановления времени ожидания (TDR), который сообщает об ошибке и требует, чтобы KMDOD повторно инициализировать себя и сбросить GPU.
Обратите внимание, что этот код состояния не должен быть возвращен для синхронного режима, как описано в примечаниях.

Драйвер также может возвращать любой другой код состояния ошибки, определенный в Ntstatus.h, чтобы указать проблемы, которые произошли с текущей операцией.

Замечания

KMDOD должен завершить все переходы на экран, прежде чем копировать грязные прямоугольники. Кроме того, KMDOD должен завершить каждую операцию перемещения и копирования перед началом другой операции перемещения или копирования.

Операционная система поддерживает два режима присутствующих операций KMDOD: синхронные и асинхронные. В зависимости от реализации оборудования и драйвера KMDOD может использовать режим или переключаться между ними в любое время.

Операционная система гарантирует, что эта функция соответствует режиму синхронизации нулевого уровня, как определено в потоки и нулевойсинхронизации.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Настольный
заголовка	d3dkmddi.h
IRQL	PASSIVE_LEVEL