Функция D3DKMTNotifyWorkSubmission (d3dkmthk.h)

  • Статья

Важно!

Некоторые сведения относятся к предварительной версии продукта, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

D3DKMTNotifyWorkSubmission уведомляет драйвер дисплея в режиме ядра о том, что драйвер отображения пользовательского режима отправил работу в GPU.

Синтаксис

NTSTATUS D3DKMTNotifyWorkSubmission(
  D3DKMT_NOTIFY_WORK_SUBMISSION *unnamedParam1
);

Параметры

unnamedParam1

Указатель на структуру D3DKMT_NOTIFY_WORK_SUBMISSION , которая определяет очередь оборудования, в которую была отправлена работа.

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

D3DKMTNotifyWorkSubmission возвращает STATUS_SUCCESS, если ему удалось проверить связь с KMD. В противном случае возвращается соответствующий код ошибки, например STATUS_INVALID_PARAMETER, если указана недопустимая очередь оборудования или флаг.

Комментарии

KMD может указать состояние подключения к дверным звонку как D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY во время создания дверного звонка. Всякий раз, когда UMD видит состояние этого дверного звонка, он настраивает рабочий процесс отправки таким образом, чтобы после написания новой команды и вызова в дверной звонок он вызывает ядро с помощью D3DKMTNotifyWorkSubmission. Dxgkrnl перенаправляет этот вызов в KMD с помощью DxgkDdiNotifyWorkSubmission.

KMD также может динамически запрашивать уведомление после создания дверного звонка. Если KMD обнаруживает условие, при котором он должен получать уведомления об отправке работ в этой очереди оборудования, он может сначала отключить дверный звонок, вызвав DxgkCbDisconnectDoorbellDxgkrnl с состоянием D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY. Позже, когда UMD попытается повторно подключить дверный звонок, KMD может установить подключение с состоянием D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY.

Дополнительные сведения о том, как и когда KMD следует использовать эту функцию, см. в разделе DxgkDdiNotifyWorkSubmission .

Требования

Требование Значение
Минимальная версия клиента WIN11_FUTURE
Верхняя часть d3dkmthk.h

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

D3DKMT_NOTIFY_WORK_SUBMISSION

DxgkDdiNotifyWorkSubmission