D3DKMTSetDisplayMode-Funktion (d3dkmthk.h)

  • Artikel

Die Funktion D3DKMTSetDisplayMode legt die Zuordnung fest, die zum Scannen auf die Anzeige verwendet wird.

Syntax

NTSTATUS D3DKMTSetDisplayMode(
  [in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);

Parameter

[in, out] unnamedParam1

Ein Zeiger auf eine D3DKMT_SETDISPLAYMODE Struktur, die die Zuordnung beschreibt, die zum Scannen verwendet wird.

Rückgabewert

D3DKMTSetDisplayMode gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Der Anzeigemodus wurde erfolgreich festgelegt.
STATUS_DEVICE_REMOVED Die Grafikkarte wurde angehalten, oder das Anzeigegerät wurde zurückgesetzt.
STATUS_INVALID_PARAMETER Die Parameter wurden überprüft und als falsch ermittelt.
STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER Vor dem Aufruf von D3DKMTSetDisplayMode hat das Gerät keinen exklusiven Besitz der Ansicht erworben. Daher konnte das Gerät den Anzeigemodus nicht festlegen.
D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT Der OpenGL Installable Client Driver (ICD) muss das Format der Oberfläche, die der Zuordnung zugeordnet ist, die vom hPrimaryAllocation-Member von D3DKMT_SETDISPLAYMODE angegeben wird, in das Format konvertieren, das das PrivateDriverFormatAttribute-Element von D3DKMT_SETDISPLAYMODE angibt. Der ICD sollte dann D3DKMTSetDisplayMode erneut aufrufen. Die ICD könnte eine neue Zuordnung zuordnen, eine Bitblockübertragung (Bitblt) vom alten primären Auf den neuen durchführen und dann die alte primäre Instanz zerstören, solange der ICD das neue Zuordnungshandle für diese Zuordnung für alle nachfolgenden Vorgänge verwendet. Der ICD sollte diesen Vorgang wiederholen, bis D3DKMTSetDisplayMode einen anderen Rückgabewert zurückgibt.

Diese Funktion gibt möglicherweise auch andere NTSTATUS-Werte zurück.

Hinweise

Bevor der OpenGL ICD D3DKMTSetDisplayMode aufruft , um einen neuen Anzeigemodus festzulegen, der ein erweitertes Format, eine Mehrfachsamplingmethode oder beides verwendet, muss der ICD sicherstellen, dass der aktuelle GDI-Anzeigemodus dieselbe Auflösung wie der neue Anzeigemodus aufweist. Andernfalls gibt D3DKMTSetDisplayModeSTATUS_INVALID_PARAMETER zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Zielplattform Universell
Header d3dkmthk.h (include D3dkmthk.h)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

D3DKMT_SETDISPLAYMODE