DXGKDDI_MIRACAST_HANDLE_IO_CONTROL回调函数 (dispmprt.h)

项目
08/07/2023

由操作系统调用，以请求显示微型端口驱动程序处理同步 I/O 控制请求，以响应用户模式显示驱动程序对 MiracastIoControl 函数的调用。

语法

DXGKDDI_MIRACAST_HANDLE_IO_CONTROL DxgkddiMiracastHandleIoControl;

NTSTATUS DxgkddiMiracastHandleIoControl(
  [in]  PVOID DriverContext,
  [in]  PVOID MiracastContext,
  [in]  ULONG InputBufferSize,
  [in]  VOID *pInputBuffer,
  [in]  ULONG OutputBufferSize,
  [out] VOID *pOutputBuffer,
  [out] ULONG *BytesReturned
)
{...}

参数

[in] DriverContext

与显示适配器关联的上下文块的句柄。显示微型端口驱动程序的 DxgkDdiAddDevice 函数之前向 DirectX 图形内核子系统提供了此句柄。

[in] MiracastContext

由操作系统提供的 Miracast 设备上下文。此上下文由显示微型端口驱动程序在对 DxgkDdiMiracastCreateContext 函数的调用中提供。

[in] InputBufferSize

由操作系统作为 pInputBuffer 指向的输入缓冲区的大小（以字节为单位）提供。此值源自用户模式 MiracastIoControl 函数的 InputBufferSize 参数。

[in] pInputBuffer

由操作系统作为指向输入缓冲区的指针提供。此值源自用户模式 MiracastIoControl 函数的 InputBufferSize 参数。

InputBufferSize 指定缓冲区的大小。

[in] OutputBufferSize

由操作系统作为 pOutputBuffer 指向的输出缓冲区的大小（以字节为单位）提供。

此值源自用户模式 MiracastIoControl 函数的 OutputBufferSize 参数。

[out] pOutputBuffer

由操作系统作为指向输出缓冲区的指针提供。此值源自用户模式 MiracastIoControl 函数的 pOutputBuffer 参数。

OutBufferSize 指定缓冲区的大小。

[out] BytesReturned

由操作系统作为指向缓冲区的指针提供，该缓冲区保存 ULONG 类型值，即显示微型端口驱动程序在 pOutputBuffer 指向的缓冲区中返回的字节数。

返回值

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

注解

操作系统保证对 DxgkDdiMiracastIoControl 的调用发生在与调用用户模式 MiracastIoControl 请求相同的进程空间中。

即使操作系统仅从 MiracastIoControl 的相应参数复制输入和输出缓冲区大小的值，显示微型端口驱动程序也负责在使用缓冲区之前检查缓冲区大小。此外，驱动程序应使用 ProbeForRead 和/或 ProbeForWrite 函数在 try/except 调用块中执行探测操作，以验证输入缓冲区指向的任何用户模式内存。

此 I/O 控制操作通过调用用户模式 MiracastIoControl 函数进行同步处理。

同步

操作系统将 DxgkDdiMiracastCreateContext、 DxgkDdiMiracastDestroyContext 和 DxgkDdiMiracastIoControl 函数分组为 Miracast 类。

此函数的线程和同步级别由用户模式驱动程序在对 MiracastIoControl 函数的调用中设置 HardwareAccess 参数的方式设置：

如果 HardwareAccess 为 FALSE，则操作系统保证 DxgkDdiMiracastIoControl 遵循线程处理和同步二级中定义的二级同步模式。在另一个线程上下文上调用其他级别 0、1 或非 Miracast 类的 2 级函数时，可以调用 DxgkDdiMiracastIoControl。但是，一次只能调用级别 2 Miracast 类函数中的一个。
如果 HardwareAccess 为 TRUE，则 DxgkDdiMiracastIoControl 遵循线程处理和同步第三级中定义的第三级同步模式。请注意，刷新 GPU 会产生巨大的处理开销。

要求

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