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 函数来检索图面的间距。应用程序必须检索图面的间距，以正确分配应用程序随后在调用驱动程序的 EncryptionBlt 和 DecryptionBlt 函数时使用的系统内存缓冲区。