PFND3DDDI_QUERYADAPTERINFOCB回呼函式 (d3dumddi.h)

發行項
02/23/2024

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 作業系統中使用。
目標平台	桌面
標頭	d3dumddi.h (include D3dumddi.h)