IDirect3D9Ex::GetAdapterDisplayModeEx-Methode (d3d9.h)
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 |