DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT回调函数 (d3dkmddi.h)

  • 项目

DxgkDdiSetDisplayPrivateDriverFormat 函数更改视频呈现源的 private-format 属性。

语法

DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT DxgkddiSetdisplayprivatedriverformat;

NTSTATUS DxgkddiSetdisplayprivatedriverformat(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT pSetDisplayPrivateDriverFormat
)
{...}

参数

[in] hAdapter

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

[in] pSetDisplayPrivateDriverFormat

指向包含函数参数 的DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT 结构的指针。

返回值

DxgkDdiSetDisplayPrivateDriverFormat 如果成功，则返回STATUS_SUCCESS;否则，它将返回STATUS_UNSUCCESSFUL，指示驱动程序无法更改给定视频呈现源的专用格式属性。

注解

在用户模式显示驱动程序调用 pfnSetDisplayPrivateDriverFormatCb 回调函数后，DirectX 图形内核子系统调用显示微型端口驱动程序的 DxgkDdiSetDisplayPrivateDriverFormat 函数。 例如，创建全屏翻转更改时，用户模式显示驱动程序可能会调用 pfnSetDisplayPrivateDriverFormatCb 来更改视频显示源的重排格式。 然后，DirectX 图形内核子系统调用显示微型端口驱动程序的 DxgkDdiSetDisplayPrivateDriverFormat 来更改视频呈现源的专用驱动程序格式。 这允许主要分配显示在视频当前源上，而无需转换主图面。

注意DxgkDdiSetDisplayPrivateDriverFormat 不会将 pSetDisplayPrivateDriverFormat 指向DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT结构的 PrivateDriverFormatAttribute 成员指定的专用驱动程序格式应用于任何分配。 DxgkDdiSetDisplayPrivateDriverFormat 将专用驱动程序格式直接应用于视频呈现源。 例如， DxgkDdiSetDisplayPrivateDriverFormat 可能会重新编程 DAC 寄存器，以从不同的重排格式进行扫描。
 
应使 DxgkDdiSetDisplayPrivateDriverFormat 可分页。

要求

要求 值
最低受支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT

pfnSetDisplayPrivateDriverFormatCb