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 オペレーティング システム以降でサポートされています。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | d3dumddi.h (D3dumddi.h を含む) |