PFND3DDDI_RENAME コールバック関数 (d3dumddi.h)
Rename 関数は、指定されたリソースに対して LockAsync 関数が以前に返した名前変更された割り当ての使用を開始するようにユーザー モードのディスプレイ ドライバーに通知します。
構文
PFND3DDDI_RENAME Pfnd3dddiRename;
HRESULT Pfnd3dddiRename(
HANDLE hDevice,
const D3DDDIARG_RENAME *unnamedParam2
)
{...}
パラメーター
hDevice
ディスプレイ デバイスへのハンドル (つまり、グラフィックス コンテキスト)。
unnamedParam2
pData [in]
新しい割り当 てで名前 を変更するリソース内のリソースまたはサーフェスを記述するD3DDDIARG_RENAME構造体へのポインター。
戻り値
Rename は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| S_OK | リソースの名前が正常に変更されました。 |
| E_OUTOFMEMORY | 名前の変更を完了するために必要なメモリを割り当てませんでした。 |
注釈
複数プロセッサ コンピューターでは、Microsoft Direct3D ランタイムは、メイン アプリケーション スレッドからではなく、ワーカー スレッドからユーザー モードディスプレイ ドライバーの Rename 関数を呼び出します。 ランタイムは、LockAsync の pData パラメーターが指すD3DDDIARG_LOCKASYNC構造体の Flags メンバーにビット フィールド フラグを設定して、ドライバーの LockAsync 関数の呼び出しが成功するたびに、最大で 1 回 Rename を呼び出します。
Rename は、 Rename の pData パラメーターが指すD3DDDIARG_RENAME構造体の hCookie メンバーによって指定された名前変更された割り当ての使用を開始するようにドライバーに通知します。 ロックされたリソースに対してビット フィールドの破棄フラグが設定されている場合、hCookie ハンドルは LockAsync 関数によって以前に返されました。
Rename が (S_OKで) 正常に返された後、ユーザー モードのディスプレイ ドライバーは、hResource メンバーと SubResourceIndex メンバーが指定するすべてのレンダリング操作に対して hCookie が指定する割り当てを使用D3DDDIARG_RENAME必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | d3dumddi.h (D3dumddi.h を含む) |