D3DKMTSetDisplayMode-Funktion (d3dkmthk.h)
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 |