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 |