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 を含む)

こちらもご覧ください

D3DDDICB_ESCAPE

D3DDDI_DEVICECALLBACKS

DxgkDdiEscape