PFND3DDDI_GETPITCH回调函数 (d3dumddi.h)

GetPitch 函数检索受保护或不可锁定表面的音调。

语法

PFND3DDDI_GETPITCH Pfnd3dddiGetpitch;

HRESULT Pfnd3dddiGetpitch(
  HANDLE hDevice,
  D3DDDIARG_GETPITCH *unnamedParam2
)
{...}

参数

hDevice

显示设备的句柄 (图形上下文) 。

unnamedParam2

pData [in, out]

指向描述受保护图面 的D3DDDIARG_GETPITCH 结构的指针。

返回值

GetPitch 函数返回以下值之一:

返回代码 说明
S_OK 已成功检索受保护图面的间距。
D3DDDIERR_NOTAVAILABLE 驱动程序不支持 GetPitch 函数。

备注

硬件和驱动程序可以选择支持 GetPitch 函数。

GetPitch 函数返回音调的图面可以是不可锁定的或受保护的。 因此,应用程序无法通过调用驱动程序的 Lock 函数来检索图面的音调。 应用程序必须检索图面的间距,以正确分配应用程序随后在调用驱动程序的 EncryptionBltDecryptionBlt 函数时所使用的系统内存缓冲区。

要求

   
最低受支持的客户端 从 Windows 7 操作系统开始,支持 GetPitch。
目标平台 桌面
Header d3dumddi.h (包括 D3dumddi.h)

另请参阅

D3DDDIARG_GETPITCH

DecryptionBlt

EncryptionBlt