PFND3DDDI_SETDISPLAYMODE Rückruffunktion (d3dumddi.h)

Artikel
02/06/2025

Die SetDisplayMode--Funktion wechselt in einen Anzeigemodus oder eine primäre Funktion, die vom GDI-Desktop nicht unterstützt wird.

Syntax

PFND3DDDI_SETDISPLAYMODE Pfnd3dddiSetdisplaymode;

HRESULT Pfnd3dddiSetdisplaymode(
  HANDLE hDevice,
  const D3DDDIARG_SETDISPLAYMODE *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData- [in]

Ein Zeiger auf eine D3DDDIARG_SETDISPLAYMODE-Struktur, die Parameter zum Festlegen des Anzeigemodus angibt.

Rückgabewert

SetDisplayMode- gibt S_OK oder ein entsprechendes Fehlerergebnis zurück, wenn der Anzeigemodus nicht erfolgreich festgelegt wurde.

Bemerkungen

Die Microsoft Direct3D-Laufzeit ruft SetDisplayMode- auf, um in einen Anzeigemodus oder eine Primäre zu wechseln, die vom GDI-Desktop nicht unterstützt wird. Die folgende Liste beschreibt Beispiele für solche Primarien:

Primaries, die mit 10-Bit-pro-Kanal-Formaten (10:10:10:2) erstellt werden, zeigen und rendern Zielformate an (z. B. D3DFMT_A2R10G10B10)
Mehrfachbeispiele, bei denen das Mehrfach-Sampling beim Scannen durchgeführt wird
Persistente Primaries, die von Microsoft DirectX-Anwendungen mit Vollbildversion 9.L verwendet werden

Die Direct3D-Laufzeit ruft die CreateResource-Funktion des Benutzermodus auf, um die primäre zu scannende Funktion zu erstellen. Der Treiber sollte die Hardware jedoch nur so programmieren, dass sie ausgecheckt wird, wenn die SetDisplayMode--Funktion aufgerufen wird. Daher legt die Laufzeit die hResource und SubResourceIndex Member der D3DDDIARG_SETDISPLAYMODE Struktur fest, auf die der pData--Parameter verweist, auf die primäre, die durch den Aufruf der CreateResource-Funktion des Treibers erstellt wurde. Der Treiber sollte dann die primäre, die durch hResource dargestellt wird, und SubResourceIndex- in ein primäres Zuordnungshandle übersetzen. Nachdem der Treiber diese Übersetzung ausgeführt hat, sollte der Treiber das resultierende Handle in einem Aufruf der pfnSetDisplayModeCb--Funktion übergeben, wodurch dann ein Aufruf der DxgkDdiCommitVidPn--Funktion des Anzeigeminiporttreibers initiiert wird.

Der Anzeigetreiber für den Benutzermodus kann den hPrimaryAllocation- Member der D3DDDICB_SETDISPLAYMODE Struktur im Aufruf von pfnSetDisplayModeCb festlegen, um alle Zuordnungen zu scannen. Die Zuordnung muss jedoch als primär gekennzeichnet werden (d. a. der Benutzermodusanzeigetreiber muss das Primäre Bitfeldflagge im Flags Mitglied der D3DDDI_ALLOCATIONINFO Struktur in einem Aufruf der pfnAllocateCb--Funktion festgelegt haben, um die Zuordnung zu erstellen).

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)

Siehe auch

D3DDDIARG_SETDISPLAYMODE

D3DDDI_DEVICEFUNCS

pfnSetDisplayModeCb

Freigeben über