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 函数时所使用的系统内存缓冲区。