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

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

pfnQueryAdapterInfoCb 関数は、グラフィックスアダプター情報を取得します。

構文

PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;

HRESULT Pfnd3dddiQueryadapterinfocb(
  HANDLE hAdapter,
  const D3DDDICB_QUERYADAPTERINFO *unnamedParam2
)
{...}

パラメーター

hAdapter

グラフィックスアダプターオブジェクトへのハンドル。

unnamedParam2

pData [in, out]

グラフィックスハードウェアに関する情報を受け取る D3DDDICB_QUERYADAPTERINFO 構造体へのポインター。

戻り値

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

リターンコード	説明
S_OK	情報が正常に取得されました。
E_INVALIDARG	パラメーターが検証され、正しくないと判断されました。

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

注釈

Microsoft Direct3D ランタイムがユーザーモードディスプレイドライバーの CreateDevice または CreateDevice(D3D10) 関数を呼び出してグラフィックスコンテキストを作成する前に、ユーザーモードディスプレイドライバーは pfnQueryAdapterInfoCb を呼び出してグラフィックスハードウェアに関する情報を取得する必要があります。この順序は、マルチモニターシステムでは特に重要です。

pfnQueryAdapterInfoCb 呼び出しでは、ユーザーモードディスプレイドライバーは、ディスプレイミニポートドライバーが構成データを入力するバッファーを送信します。この構成データを受信すると、ランタイムがユーザーモードディスプレイドライバーの GetCaps および GetCaps (D3D10_2) 関数を呼び出すときに、ユーザーモードディスプレイドライバーはその機能を正確に報告できます。ランタイムは、その後、D3DDDI_DEVICEFUNCS、D3D10DDI_DEVICEFUNCS 、または D3D11DDI_DEVICEFUNCS構造体で指定されている他のユーザーモードディスプレイドライバー関数を呼び出すと、ユーザーモードディスプレイドライバーは、ハードウェアで処理できるコマンドストリームを生成できます。

例

次のコード例は、グラフィックスアダプター情報を取得する方法を示しています。

    HRESULT hr;
    // Query for GART segment support
    D3DDDICB_QUERYADAPTERINFO   ddiQueryAdapterInfo;

    memset(&R200AdapterInfo, 0, sizeof(R200AdapterInfo));

    ddiQueryAdapterInfo.pPrivateDriverData = &R200AdapterInfo;
    ddiQueryAdapterInfo.PrivateDriverDataSize = sizeof(R200AdapterInfo);

    hr = m_Callbacks.pfnQueryAdapterInfoCb(m_hAdapter, &ddiQueryAdapterInfo);
    if (FAILED(hr)) {
        return FALSE;
    }

    m_ulGartSupported = R200AdapterInfo.ulGartSupported;

要件

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