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

Статья
02/06/2025

Создает контекст режима ядра для устройства Miracast.

Синтаксис

DXGKDDI_MIRACAST_CREATE_CONTEXT DxgkddiMiracastCreateContext;

NTSTATUS DxgkddiMiracastCreateContext(
  [in]  PVOID DriverContext,
  [in]  DXGK_MIRACAST_DISPLAY_CALLBACKS *MiracastCallbacks,
  [out] PVOID *MiracastContext,
  [out] ULONG *TargetId
)
{...}

Параметры

[in] DriverContext

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

[in] MiracastCallbacks

Указатель на предоставленный операционной системой буфер, содержащий DXGK_MIRACAST_DISPLAY_CALLBACKS структуру, которая содержит указатели на функции обратного вызова, которые драйвер может вызывать.

[out] MiracastContext

Указатель на предоставленный операционной системой буфер, содержащий адрес контекста, выделенного драйвером для этого экземпляра устройства Miracast.

[out] TargetId

Указатель на предоставленный операционной системой буфер, содержащий идентификатор целевого объекта VidPN, к которому подключено устройство Miracast. Драйвер должен сообщить об этом целевом объекте как тип D3DKMDT_VOT_MIRACAST при вызове функции DxgkDdiQueryChildRelations во время инициализации устройства.

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

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

Возвращаемый код	Описание
STATUS_RESOURCE_IN_USE	Аппаратные ресурсы, необходимые для поддержки подключенного сеанса Miracast, в настоящее время недоступны.

Замечания

При вызове этой функции драйвер мини-порта отображения должен подготовить все ресурсы режима ядра, которые необходимо поддерживать подключенный сеанс Miracast.

синхронизация

Операционная система группируют DxgkDdiMiracastCreateContext, DxgkDdiMiracastDetextDetextи DxgkDdiMiracastIoControl в качестве класса Miracast. Операционная система гарантирует, что эти функции соответствуют режиму синхронизации второго уровня, как определено в потоков и второго уровня синхронизации. Эти функции можно вызывать при вызове других классов 0, 1 или других классов функций уровня 2 в другом контексте потока. Однако одновременно можно вызывать только одну из этих функций класса Miracast-class.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8.1
минимальный поддерживаемый сервер	Windows Server 2012 R2
целевая платформа	Настольный
заголовка	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

См. также

DXGK_MIRACAST_DISPLAY_CALLBACKS

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

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