DXGKARG_OPENALLOCATION 结构 (d3dkmddi.h)

DXGKARG_OPENALLOCATION结构描述显示微型端口驱动程序应打开的分配。

语法

typedef struct _DXGKARG_OPENALLOCATION {
  [in]     UINT                     NumAllocations;
  [in/out] DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  [in]     VOID                     *pPrivateDriverData;
  [in]     UINT                     PrivateDriverSize;
  [in]     DXGK_OPENALLOCATIONFLAGS Flags;
  [in]     UINT                     SubresourceIndex;
  [out]    SIZE_T                   SubresourceOffset;
  [out]    UINT                     Pitch;
} DXGKARG_OPENALLOCATION;

成员

[in] NumAllocations

pOpenAllocation 成员指定的数组中的元素数,表示要打开的特定于设备的分配数。

[in/out] pOpenAllocation

要打开 的分配DXGK_OPENALLOCATIONINFO 结构的数组。

[in] pPrivateDriverData

指向从用户模式显示驱动程序传递到显示微型端口驱动程序的私有数据块的指针。 此专用数据块与在调用 DxgkDdiCreateAllocation 函数时传入 DXGKARG_CREATEALLOCATION 结构的 pPrivateDriverData 成员中的特定于资源的数据相同。 显示微型端口驱动程序无法修改此专用数据块。

[in] PrivateDriverSize

pPrivateDriverData 指向的私有数据块的大小(以字节为单位)。

[in] Flags

标识要对分配执行的操作 的DXGK_OPENALLOCATIONFLAGS 结构。

[in] SubresourceIndex

从 Windows 8 开始支持。

呈现目标图面的资源索引。

仅当显示微型端口驱动程序支持 GDI 硬件加速时,操作系统才指定此成员。 具体而言,显示微型端口驱动程序必须实现 DxgkDdiRenderKm 函数,并且必须使用 DXGKARG_CREATEDEVICE 中设置的 GdiDevice 成员创建设备。标志

如果 SubresourceIndex 的值大于分配中的子资源数,则显示微型端口驱动程序应返回错误。

[out] SubresourceOffset

从 Windows 8 开始支持。

从分配开始到子资源开头的偏移量(以字节为单位)。

[out] Pitch

从 Windows 8 开始支持。

分配的间距(以字节为单位),即到下一行开头的距离(以字节为单位)。

要求

要求
最低受支持的客户端 从 Windows Vista 开始可用。
标头 d3dkmddi.h (包括 D3dkmddi.h)

另请参阅

DXGKARG_CREATEALLOCATION

DXGK_OPENALLOCATIONFLAGS

DXGK_OPENALLOCATIONINFO

DxgkDdiCreateAllocation

DxgkDdiOpenAllocation