PFND3DDDI_OFFERALLOCATIONSCB コールバック関数 (d3dumddi.h)
再利用のためにビデオ メモリ割り当てを提供するために、ユーザー モード ディスプレイ ドライバーによって呼び出されます。
構文
PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;
HRESULT Pfnd3dddiOfferallocationscb(
HANDLE hDevice,
const D3DDDICB_OFFERALLOCATIONS *unnamedParam2
)
{...}
パラメーター
hDevice
ディスプレイ デバイス (グラフィックス コンテキスト) へのハンドル。 Direct3D ランタイムは、ユーザー モード ドライバーにこのハンドルを、デバイスの作成時にD3DDDIARG_CREATEDEVICE構造体の hDevice メンバーとして渡しました。
unnamedParam2
pData [in]
ドライバーが提供するビデオ メモリ割り当てを定義する D3DDDICB_OFFERALLOCATIONS 構造体へのポインター。
戻り値
次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| S_OK | 割り当てが正常に提供されました。 メモ： ドライバーが pfnOfferAllocationsCb を呼び出す必要がない場合は、S_OKを返す必要があります。 |
| D3DDDIERR_DEVICEREMOVED | ビデオ メモリ マネージャーまたはディスプレイ ミニポート ドライバーは、プラグ アンド プレイ (PnP) 停止イベントまたはタイムアウト検出と回復 (TDR) イベントが発生したため、操作を完了できませんでした。 メモ： このエラー コードが返された場合、ドライバーの呼び出し元関数 (通常は pfnOfferResources ルーチン) は、このエラー コードを Direct3D ランタイムに返す必要があります。 |
| E_INVALIDARG | 無効なパラメーターが指定されました。 |
注釈
ユーザー モード ディスプレイ ドライバーは pfnOfferAllocationsCb を呼び出して、以前に送信されたレンダリング操作を完了した後、他のプロセスで使用する割り当てのメモリを提供できることを Microsoft DirectX グラフィックス カーネル サブシステムに通知します。
ドライバーは、再使用する割り当てを提供するために pfnOfferAllocationsCb を呼び出した後、割り当てをロックするか、レンダリング操作のために送信する前に pfnReclaimAllocationsCb を 呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dumddi.h (D3dumddi.h を含む) |