PFND3DDDI_ESCAPECB コールバック関数 (d3dumddi.h)
pfnEscapeCb コールバック関数は、ディスプレイ ミニポート ドライバーと情報を共有します。
構文
PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;
HRESULT Pfnd3dddiEscapecb(
HANDLE hAdapter,
const D3DDDICB_ESCAPE *unnamedParam2
)
{...}
パラメーター
hAdapter
グラフィックス アダプター オブジェクトへのハンドル。
unnamedParam2
pData [in, out]
共有情報を記述する D3DDDICB_ESCAPE 構造体へのポインター。
戻り値
pfnEscapeCb は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| S_OK | 情報が正常に共有されました。 |
| E_OUTOFMEMORY | メモリ不足のため、pfnEscapeCb を完了できませんでした。 |
| E_INVALIDARG | パラメーターが検証され、正しくないと判断されました。 |
| D3DDDIERR_DEVICEREMOVED | pfnEscapeCb は、プラグ アンド プレイ (PnP) の停止またはタイムアウト検出と回復 (TDR) イベントが発生したため、ディスプレイ ミニポート ドライバーの DxgkDdiEscape 関数の呼び出しを開始できませんでした。 pfnEscapeCb を呼び出したユーザー モード表示ドライバー関数は、このエラー コードを Direct3D ランタイムに返す必要があります。 Direct3D バージョン 9 注: エラー コードの返し方の詳細については、「 ランタイム関数から受信したエラー コードを返す」を参照してください。 Direct3D バージョン 10 および 11 注: ドライバー関数が値を返さない場合 (つまり、戻り値のパラメーター型に VOID がある場合)、ドライバー関数は pfnSetErrorCb 関数を呼び出してエラー コードをランタイムに返します。 エラー コードの処理の詳細については、「エラーの 処理」を参照してください。 |
この関数は、他の HRESULT 値も返す場合があります。
注釈
ユーザー モードディスプレイ ドライバーは pfnEscapeCb を呼び出して、他のドライバー通信でサポートされていない方法で、その他の情報をディスプレイ ミニポート ドライバーと共有します。 ユーザー モードディスプレイ ドライバーは、ディスプレイ ミニポート ドライバーにその他の情報を送信するか、ディスプレイ ミニポート ドライバーから情報を取得できます。
Direct3D バージョン 11 注: ドライバーが pfnEscapeCb を呼び出す方法の詳細については、「 Direct3D 10 からの変更」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dumddi.h (D3dumddi.h を含む) |