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

こちらもご覧ください

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocationsCb