PFND3DDDI_QUERYADAPTERINFOCB Rückruffunktion (d3dumddi.h)
Die pfnQueryAdapterInfoCb Funktion ruft Grafikadapterinformationen ab.
Syntax
PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;
HRESULT Pfnd3dddiQueryadapterinfocb(
HANDLE hAdapter,
const D3DDDICB_QUERYADAPTERINFO *unnamedParam2
)
{...}
Parameter
hAdapter
Ein Handle für das Grafikadapterobjekt.
unnamedParam2
pData- [in, out]
Ein Zeiger auf eine D3DDDICB_QUERYADAPTERINFO Struktur, die Informationen über die Grafikhardware empfängt.
Rückgabewert
pfnQueryAdapterInfoCb gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Informationen wurden erfolgreich abgerufen. |
| E_INVALIDARG | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
Diese Funktion kann auch andere HRESULT-Werte zurückgeben.
Bemerkungen
Bevor die Microsoft Direct3D-Laufzeit die CreateDevice oder CreateDevice(D3D10)--Funktion aufruft, um den Grafikkontext zu erstellen, sollte der Anzeigetreiber für den Benutzermodus pfnQueryAdapterInfoCb aufrufen, um Informationen zur Grafikhardware abzurufen. Diese Reihenfolge ist besonders wichtig für ein System mit mehreren Monitoren.
Im pfnQueryAdapterInfoCb Aufruf sendet der Anzeigetreiber für den Benutzermodus einen Puffer, den der Miniporttreiber mit Konfigurationsdaten ausfüllt. Nach Erhalt dieser Konfigurationsdaten kann der Benutzermodusanzeigetreiber seine Funktionen genau melden, wenn die Laufzeit die GetCaps-- und GetCaps(D3D10_2)-Funktionen des Benutzermodusanzeigetreibers aufruft. Wenn die Laufzeit anschließend andere Benutzermodusanzeigetreiberfunktionen aufruft, die in der D3DDDI_DEVICEFUNCS, D3D10DDI_DEVICEFUNCSoder D3D11DDI_DEVICEFUNCS Struktur angegeben sind, kann der Anzeigetreiber für den Benutzermodus Befehlsdatenströme generieren, die von der Hardware verarbeitet werden können.
Beispiele
Das folgende Codebeispiel zeigt, wie Grafikadapterinformationen abgerufen werden.
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;
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |