PFND3DDDI_QUERYADAPTERINFOCB回呼函式 （d3dumddi.h）
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 （包括 D3dumddi.h） |