Share via

IDirect3D9Ex::GetAdapterDisplayModeEx-Methode (d3d9.h)

  • Artikel

Ruft die aktuellen Anzeigemodus- und Rotationseinstellungen des Adapters ab.

Syntax

HRESULT GetAdapterDisplayModeEx(
  [in]      UINT               Adapter,
  [in, out] D3DDISPLAYMODEEX   *pMode,
  [in, out] D3DDISPLAYROTATION *pRotation
);

Parameter

[in] Adapter

Typ: UINT

Ordnungszahl, die den abzufragenden Anzeigeadapter angibt. D3DADAPTER_DEFAULT ist immer der primäre Grafikkarte.

[in, out] pMode

Typ: D3DDISPLAYMODEEX*

Zeiger auf eine D3DDISPLAYMODEEX-Struktur , die Daten zum Anzeigemodus des Adapters enthält. Im Gegensatz zum Anzeigemodus des Geräts, der möglicherweise nicht aktiv ist, wenn das Gerät keinen Vollbildmodus besitzt. Kann auf NULL festgelegt werden.

[in, out] pRotation

Typ: D3DDISPLAYROTATION*

Zeiger auf eine D3DDISPLAYROTATION-Struktur , die den Typ der Bildschirmrotation angibt, die die Anwendung ausführen wird. Der über diesen Zeiger zurückgegebene Wert ist wichtig, wenn das flag D3DPRESENTFLAG_NOAUTOROTATE verwendet wird. Andernfalls kann er auf NULL festgelegt werden.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK.

Wenn adapter außerhalb des Bereichs liegt oder pMode ungültig ist, gibt diese Methode D3DERR_INVALIDCALL zurück.

Hinweise

GetAdapterDisplayModeEx gibt nicht das richtige Format zurück, wenn die Anzeige in einem erweiterten Format wie 2:10:10:10:10 ist. Stattdessen wird das Format X8R8G8B8 zurückgegeben.

Für Anwendungen mit Fenstern gibt der Wert S_PRESENT_MODE_CHANGED, der von PresentEx oder CheckDeviceState zurückgegeben wird, an, dass sich der Anzeigemodus geändert hat und dass der aktuelle Anzeigemodus möglicherweise ein anderes Format hat. Um eine Farbkonvertierung von "Present blt" zu vermeiden, können Anwendungen mit Fenstern optional neue Anzeigemodusinformationen abrufen, indem sie diese Methode verwenden und ihr Swapchainformat entsprechend anpassen. Diese Methode gibt D3DERR_NOTAVAILABLE zurück, wenn dieser Kopf nicht mehr Teil des Desktops ist oder wenn der Monitor getrennt ist.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d9.h
Bibliothek D3D9.lib

Weitere Informationen

IDirect3D9Ex