Поделиться через


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

DXGKDDI_CREATECPUEVENT создает объект события драйвера в режиме ядра (KMD) ЦП для соответствующего объекта Dxgkrnl.

Синтаксис

DXGKDDI_CREATECPUEVENT DxgkddiCreatecpuevent;

NTSTATUS DxgkddiCreatecpuevent(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CREATECPUEVENT pArgs
)
{...}

Параметры

hAdapter

[in] Обработка контекста KMD, связанного с адаптером дисплея. Ранее этот дескриптор отображался для dxgkrnl в параметре вывода MiniportDeviceContext функции DXGKDDI_ADD_DEVICE.

pArgs

[in/out] Указатель на структуру DXGKARG_CREATECPUEVENT с дополнительными параметрами.

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

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

Замечания

Объекты синхронизации событий ЦП KMD связаны с объектом устройства (hKmdDevice). При уничтожении объекта устройства Dxgkrnl уничтожит все связанные объекты синхронизации событий ЦП KMD путем вызова DXGKDDI_DESTROYCPUEVENT.

KMD может сигнализировать о событии, вызвав DXGKCB_SIGNALEVENT и предоставив дескр иптор hDxgCpuEvent.

Время существования объекта события ЦП не зависит от времени существования устройства KMD; То есть объект может быть уничтожен после уничтожения устройства. hKmdDevice передается, чтобы драйвер смог связать объекты процесса KMD (созданные DXGKDDI_CREATEPROCESS) с объектом события ЦП.

Дополнительные сведения см. в статье Сигнал о событии ЦП из KMD.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 11 версии 21H2 (WDDM 3.0)
заголовка d3dkmddi.h
IRQL PASSIVE_LEVEL

См. также

DXGKARG_CREATECPUEVENT

DXGKDDI_DESTROYCPUEVENT