PFND3DDDI_QUERYADAPTERINFOCB Rückruffunktion (d3dumddi.h)

Artikel
02/26/2024

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)