通过

PFND3D10DDI_CHECKFORMATSUPPORT回调函数 （d3d10umddi.h）

  • 项目

检索设备具有指定格式的功能。

语法

PFND3D10DDI_CHECKFORMATSUPPORT Pfnd3d10ddiCheckformatsupport;

void Pfnd3d10ddiCheckformatsupport(
  D3D10DDI_HDEVICE unnamedParam1,
  DXGI_FORMAT unnamedParam2,
  UINT *unnamedParam3
)
{...}

参数

unnamedParam1

hDevice [in]

显示设备的句柄（图形上下文）。

unnamedParam2

格式 [in]

DXGI_FORMAT 类型化值，指示要检索其功能的像素格式。

unnamedParam3

pFormatCaps [out]

指向一个变量的指针，该变量接收有效位 或 指示功能的值。

价值 描述
D3D10_DDI_FORMAT_SUPPORT_SHADER_SAMPLE（0x00000001） 可以使用着色器中的任何筛选器对格式进行采样。
D3D10_DDI_FORMAT_SUPPORT_RENDERTARGET（0x00000002） 格式可以是呈现目标。
D3D10_DDI_FORMAT_SUPPORT_BLENDABLE （0x00000004） 格式是可混合的。 （仅当格式可以是呈现目标时，才能设置此值。
D3D10_DDI_FORMAT_SUPPORT_MULTISAMPLE_RENDERTARGET（0x00000008） 格式可以是具有大于一个样本计数的呈现目标。
D3D10_DDI_FORMAT_SUPPORT_MULTISAMPLE_LOAD（0x00000010） 该格式可用于从多样本资源读取单个样本。
D3D10_DDI_FORMAT_SUPPORT_NOT_SUPPORTED（0x80000000） 显示设备根本不支持格式。 请参阅“备注”。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_DECODER_OUTPUT（0x00000020） 格式可以作为解码输出资源支持。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_VIDEO_PROCESSOR_OUTPUT（0x00000040） 格式可以是视频处理器输出资源。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_VIDEO_PROCESSOR_INPUT（0x00000080） 格式可以是视频处理器输入资源。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_VERTEX_BUFFER（0x00000100） 格式可以是顶点缓冲区。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_UAV_WRITES（0x00000200） 格式可以通过无序访问视图（UAV）追加缓冲区编写。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_BUFFER（0x00000400） 该格式可在类型化的缓冲区视图中使用。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_CAPTURE （0x00000800） 格式可以作为视频捕获引擎的输出支持。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_VIDEO_ENCODER（0x00001000） 格式可以作为硬件编码媒体基础转换（MFT）的输入支持。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_OUTPUT_MERGER_LOGIC_OP（0x00002000） 该格式支持着色器逻辑作。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_SHADER_GATHER（0x00004000） 该格式支持“着色器 gather4”资源属性。 从 Windows 8 开始可用。
D3D11_1DDI_FORMAT_SUPPORT_MULTIPLANE_OVERLAY （0x00008000） 该格式支持多平面覆盖。 从 Windows 8 开始可用。 但是，多平面覆盖仅在 WDDM 1.3 及更高版本中受支持，这些驱动程序是在 Windows 8.1 中引入的。
D3DWDDM1_3DDI_FORMAT_SUPPORT_TILED（0x00010000） 该格式支持在D3D10DDIRESOURCE_TEXTURE1D、D3D10DDIRESOURCE_TEXTURE2D或D3D10DDIRESOURCE_TEXTURECUBE类型的平铺资源中使用。 从 Windows 8.1 开始可用，仅 WDDM 1.3 及更高版本驱动程序支持。

返回值

没有

言论

D3D10_DDI_FORMAT_SUPPORT_NOT_SUPPORTED值仅适用于以下格式：

  • DXGI_FORMAT_A8P8
  • DXGI_FORMAT_AI44
  • DXGI_FORMAT_AYUV
  • DXGI_FORMAT_IA44
  • DXGI_FORMAT_NV11
  • DXGI_FORMAT_P010
  • DXGI_FORMAT_P016
  • DXGI_FORMAT_P8
  • DXGI_FORMAT_R10G10B10_XR_BIAS_A2_UNORM
  • DXGI_FORMAT_Y210
  • DXGI_FORMAT_Y216
  • DXGI_FORMAT_Y410
  • DXGI_FORMAT_Y416

对于这些格式，应仅设置此位。

驱动程序可以使用 pfnSetErrorCb 回调函数设置错误代码，如下所示：

  • 如果 Format 参数中的格式不存在，则设置为E_FAIL。
  • 如果 pFormatCaps 参数为 NULL，则设置为E_INVALIDARG。

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的 Windows作系统中可用。
目标平台 桌面
标头 d3d10umddi.h （包括 D3d10umddi.h）

另请参阅

D3D10DDI_DEVICEFUNCS

DXGI_FORMAT

DXGI_FORMAT_R10G10B10_XR_BIAS_A2_UNORM

pfnSetErrorCb