PFND3DDDI_PRESENTCB コールバック関数 (d3dumddi.h)

[アーティクル]
08/07/2023

pfnPresentCb 関数は、ソース割り当てからコンテンツをコピーします。

構文

PFND3DDDI_PRESENTCB Pfnd3dddiPresentcb;

HRESULT Pfnd3dddiPresentcb(
  HANDLE hDevice,
  D3DDDICB_PRESENT *unnamedParam2
)
{...}

パラメーター

hDevice

ディスプレイデバイス (グラフィックスコンテキスト) へのハンドル。

unnamedParam2

pData [in]

コンテンツのコピー元のソース割り当てを記述する D3DDDICB_PRESENT 構造体へのポインター。

戻り値

pfnPresentCb は、次のいずれかの値を返します。

リターンコード	説明
S_OK	コンテンツが正常にコピーされました。
E_OUTOFMEMORY	メモリ不足のため、pfnPresentCb を完了できませんでした。
E_INVALIDARG	パラメーターが検証され、正しくないと判断されました。

この関数は、他の HRESULT 値も返す場合があります。

注釈

ユーザーモード表示ドライバーは、pData パラメーターによって指されるD3DDDICB_PRESENT構造体の hContext メンバーを、pfnCreateContextCb 関数を呼び出して以前に作成したコンテキストに設定します。ユーザーモードディスプレイドライバーは、Microsoft Direct3D ランタイムがドライバーの CreateDevice または CreateDevice(D3D10) 関数を呼び出してデバイスを作成するときに、少なくとも 1 つのコンテキストを作成する必要があります。 Direct3D ランタイムは、作成されたコンテキストに現在の操作を送信します。

Direct3D バージョン 11 注: ドライバーが pfnPresentCb を呼び出す方法の詳細については、「 Direct3D 10 からの変更」を参照してください。

例

次のコード例は、変換先サーフェスを色分けする方法を示しています。

    HRESULT hr=S_OK;
    // A color-fill request that does not have a source surface
    D3DDDICB_PRESENT    PresentCBData = {0};

    PresentCBData.hContext = m_sContexts[MULTI_ENGINE_NODE_3D].hContext;
    PresentCBData.hSrcAllocation = NULL;

    if (pPresent->hDstResource) {
        DWORD   dwDstSurf = ((DWORD)(DWORD_PTR)pPresent->hDstResource) + pPresent->DstSubResourceIndex;
        _ASSERT(dwDstSurf < m_RTbl.Size());
        m_RTbl[dwDstSurf].m_qwBatch = m_qwBatch;
        PresentCBData.hDstAllocation = R200GetSurfaceAllocHandle(m_pR200Ctx, dwDstSurf);
    }

    hr = m_d3dCallbacks.pfnPresentCb(m_hD3D, &PresentCBData);

    return hr;

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	デスクトップ
Header	d3dumddi.h (D3dumddi.h を含む)