次の方法で共有


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

関連項目

D3DDDICB_ESCAPE

D3DDDI_DEVICECALLBACKS

dxgkDdiEscape する