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 |