PFND3DDDI_QUERYADAPTERINFOCB Rückruffunktion (d3dumddi.h)
Die pfnQueryAdapterInfoCb-Funktion ruft Grafikkarteninformationen 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 zur Grafikhardware empfängt.
Rückgabewert
pfnQueryAdapterInfoCb gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Informationen wurden erfolgreich abgerufen. |
| E_INVALIDARG | Die Parameter wurden überprüft und als falsch ermittelt. |
Diese Funktion gibt möglicherweise auch andere HRESULT-Werte zurück.
Hinweise
Bevor die Microsoft Direct3D-Runtime die CreateDevice - oder CreateDevice(D3D10) -Funktion des Benutzermodusanzeigetreibers aufruft, um den Grafikkontext zu erstellen, sollte der Benutzermodusanzeigetreiber 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 Anzeigeminiporttreiber mit Konfigurationsdaten auffüllt. Nach dem Empfang dieser Konfigurationsdaten kann der Benutzermodusanzeigetreiber seine Funktionen genau melden, wenn die Runtime die Funktionen GetCaps und GetCaps (D3D10_2) des Benutzermodusanzeigetreibers aufruft. Wenn die Laufzeit anschließend andere Anzeigetreiberfunktionen im Benutzermodus aufruft, die in der D3DDDI_DEVICEFUNCS-, D3D10DDI_DEVICEFUNCS- oder D3D11DDI_DEVICEFUNCS-Struktur angegeben sind, kann der Benutzermodusanzeigetreiber Befehlsstreams generieren, die die Hardware verarbeiten kann.
Beispiele
Im folgenden Codebeispiel wird gezeigt, wie Sie Grafikkarteninformationen abrufen.
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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |