共用方式為


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 EncryptionBltDecryptionBlt 函式時所使用的系統記憶體緩衝區。

要求

要求 價值
最低支援的用戶端 從 Windows 7作系統開始支援 GetPitch。
目標平臺 桌面
標頭 d3dumddi.h (包括 D3dumddi.h)

另請參閱

D3DDDIARG_GETPITCH

DecryptionBlt

EncryptionBlt