D3DKMTSetDisplayMode-Funktion (d3dkmthk.h)
Die D3DKMTSetDisplayMode--Funktion 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 Auschecken 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 | Der Grafikkarte wurde beendet, oder das Anzeigegerät wurde zurückgesetzt. |
| STATUS_INVALID_PARAMETER | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
| STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER | Vor dem Aufruf von D3DKMTSetDisplayModehat das Gerät keinen exklusiven Besitz der Ansicht erworben. Daher konnte das Gerät den Anzeigemodus nicht festlegen. |
| D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT | Der installierbare OpenGL-Clienttreiber (ICD) muss das Format der Oberfläche konvertieren, die der Zuordnung zugeordnet ist, die das hPrimaryAllocation Mitglied von D3DKMT_SETDISPLAYMODE in das Formatattribut angibt, das das PrivateDriverFormatAttribute Member von D3DKMT_SETDISPLAYMODE angibt. Die ICD sollte dann D3DKMTSetDisplayMode erneut aufrufen. Die ICD könnte eine neue Zuordnung zuweisen, eine Konvertierungsbitblockübertragung (Bitblt) von der alten Primär in die neue durchführen und dann die alte Primäre zerstören, solange die ICD den neuen 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 kann auch andere NTSTATUS- Werte zurückgeben.
Bemerkungen
Bevor openGL ICD D3DKMTSetDisplayMode aufruft, um einen neuen Anzeigemodus festzulegen, der ein erweitertes Format, eine Multiple-Sampling-Methode oder beides verwendet, muss die ICD sicherstellen, dass der aktuelle GDI-Anzeigemodus dieselbe Auflösung wie der neue Anzeigemodus aufweist. Andernfalls gibt D3DKMTSetDisplayModeSTATUS_INVALID_PARAMETERzurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Universal |
| Header- | d3dkmthk.h (einschließlich D3dkmthk.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |