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 | プラグ アンド プレイ (PnP) の停止またはタイムアウト検出と回復 (TDR) イベントが発生したため、pfnEscapeCb はディスプレイ ミニポート ドライバーの DxgkDdiEscape 関数への呼び出しを開始できませんでした。 pfnEscapeCb を呼び出したユーザー モードのディスプレイ ドライバー関数は、このエラー コードを Direct3D ランタイムに返す必要があります。 Direct3D バージョン 9 注: エラー コードの返しの詳細については、「ランタイム関数 から受信したエラー コードを返すを参照してください。 Direct3D バージョン 10 および 11 注: ドライバー関数が値を返さない場合 (つまり、戻り値のパラメーター型に VOID がある場合)、ドライバー関数は pfnSetErrorCb 関数 を呼び出して、エラー コードをランタイムに返します。 エラー コードの処理の詳細については、「エラー の処理」を参照してください。 |
この関数は、他の HRESULT 値を返す場合もあります。
備考
ユーザー モードディスプレイ ドライバーは、pfnEscapeCb を呼び出して、他のドライバー通信でサポートされていない方法で、ディスプレイ ミニポート ドライバーとその他の情報を共有します。 ユーザー モードのディスプレイ ドライバーは、ディスプレイ ミニポート ドライバーに、その他の情報を送信したり、ディスプレイ ミニポート ドライバーから情報を取得できます。
Direct3D バージョン 11 注: ドライバーが pfnEscapeCb 呼び出す方法の詳細については、「Direct3D 10 からの変更を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | d3dumddi.h (D3dumddi.h を含む) |
関連項目
dxgkDdiEscape を する