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 连接会话所需的所有内核模式资源。

同步

作系统将 DxgkDdiMiracastCreateContextDxgkDdiMiracastDestroyContextDxgkDdiMiracastIoControl 函数作为 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