DXGK_OPENALLOCATIONINFO 结构 (d3dkmddi.h)

项目
02/23/2024

DXGK_OPENALLOCATIONINFO 结构包含 DxgkDdiOpenAllocation 函数关联的非特定于设备的分配和特定于设备的句柄。

语法

typedef struct _DXGK_OPENALLOCATIONINFO {
  [in]     D3DKMT_HANDLE hAllocation;
  [in/out] VOID          *pPrivateDriverData;
  [in]     UINT          PrivateDriverDataSize;
  [out]    HANDLE        hDeviceSpecificAllocation;
} DXGK_OPENALLOCATIONINFO;

成员

[in] hAllocation

D3DKMT_HANDLE数据类型，表示 DxgkDdiCreateAllocation 函数创建的非特定于设备的分配的内核模式句柄。 Microsoft DirectX 图形内核子系统 (，它是 Dxgkrnl.sys) 分配此句柄的一部分。

[in/out] pPrivateDriverData

指向在用户模式显示驱动程序和显示微型端口驱动程序之间传递的私有数据块的指针。此私有数据块与在调用 DxgkDdiCreateAllocation 函数时在 DXGK_ALLOCATIONINFO 结构的 pPrivateDriverData 成员中传递的特定于分配的数据相同。如果在 DXGKARG_OPENALLOCATION 结构的Flags 成员中设置了创建位字段标志，则显示微型端口驱动程序的 DxgkDdiOpenAllocation 函数可以修改此私有数据块。用户模式显示驱动程序可以访问对私有数据块的修改。

[in] PrivateDriverDataSize

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

[out] hDeviceSpecificAllocation

特定于设备的分配的句柄，对应于 hAllocation 指定的非特定于设备的分配。显示微型端口驱动程序必须将 hDeviceSpecificAllocation 设置为句柄值，该句柄值可用于引用分配的专用跟踪结构。