DXGKDDI_MIRACAST_CREATE_CONTEXT回调函数 (dispmprt.h)

  • 项目

为 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

指向操作系统提供的缓冲区的指针，该缓冲区保存 Miracast 设备连接到的 VidPN 目标的 ID。 当操作系统在设备初始化期间调用 DxgkDdiQueryChildRelations 函数时，驱动程序应将此目标报告为类型D3DKMDT_VOT_MIRACAST。

返回值

如果成功 ， 则返回STATUS_SUCCESS。 否则，它将返回 Ntstatus.h 中定义的错误代码之一，包括：

返回代码 说明
STATUS_RESOURCE_IN_USE 支持 Miracast 连接会话所需的硬件资源当前不可用。

注解

调用此函数时，显示微型端口驱动程序应准备支持 Miracast 连接会话所需的所有内核模式资源。

同步

操作系统将 DxgkDdiMiracastCreateContext、 DxgkDdiMiracastDestroyContext 和 DxgkDdiMiracastIoControl 函数分组为 Miracast 类。 操作系统保证这些函数遵循线程和同步二级中定义的 二级同步模式。 当在另一个线程上下文上调用其他级别 0、1 或其他级别 2 函数的类时，可以调用这些函数。 但是，一次只能调用其中一个级别 2 Miracast 类函数。

要求

要求 值
最低受支持的客户端 Windows 8.1
最低受支持的服务器 Windows Server 2012 R2
目标平台 桌面
标头 dispmprt.h (包括 Dispmprt.h)
IRQL PASSIVE_LEVEL

另请参阅

DXGK_MIRACAST_DISPLAY_CALLBACKS

DxgkDdiAddDevice

DxgkDdiQueryChildRelations