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 関数の呼び出しでアプリケーションが後で使用するシステム メモリ バッファーを適切に割り当てるために、サーフェスのピッチを取得する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | GetPitch は、Windows 7 オペレーティング システム以降でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dumddi.h (D3dumddi.h を含む) |