D3DKMTGetDisplayModeList-Funktion (d3dkmthk.h)

Die D3DKMTGetDisplayModeList-Funktion ruft eine Liste der verfügbaren Anzeigemodi ab, einschließlich Modi mit erweitertem Format.

Syntax

NTSTATUS D3DKMTGetDisplayModeList(
  D3DKMT_GETDISPLAYMODELIST *unnamedParam1
);

Parameter

unnamedParam1

[in/out] pData ist ein Zeiger auf eine D3DKMT_GETDISPLAYMODELIST-Struktur , die die Argumente für diese Funktion enthält.

Rückgabewert

D3DKMTGetDisplayModeList gibt einen NTSTATUS-Wert zurück, z. B. einen der folgenden.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Liste der verfügbaren Anzeigemodi wurde erfolgreich abgerufen, oder die Anzahl der Anzeigemodi wurde in pData-ModeCount> zurückgegeben, wenn pData-pModeList> NULL und pData-ModeCount> bei der Eingabe null war.
STATUS_DEVICE_REMOVED	Die Grafikkarte wurde beendet.
STATUS_BUFFER_TOO_SMALL	Der Puffer, den der Clienttreiber in pData-pModeList> bereitgestellt hat, ist nicht groß genug, um die angeforderte Anzeigemodusliste zu enthalten.
STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET	Für die Verwendung mit der vorhandenen Videoquelle, die durch pData-VidPnSourceId> identifiziert wird, ist kein vorhandenes Videoziel verfügbar. Daher sind für diese Quelle keine Anzeigemodi verfügbar.
STATUS_INVALID_PARAMETER**	Die Parameter wurden überprüft und als falsch ermittelt.

Hinweise

Um die Anzahl der Anzeigemodi für die angegebene VidPn-Quelle (pData-VidPnSourceId>) auf dem Grafikkarte (pData-hAdapter>) abzurufen, kann ein Clienttreiber D3DKMTGetDisplayModeList aufrufen, wobei pData-pModeList> auf NULL und pData-ModeCount> als 0 festgelegt ist. Wenn dieser Aufruf STATUS_SUCCESS zurückgibt, ist der zurückgegebene pData-ModeCount> die Gesamtanzahl der Anzeigemodi. Der Clienttreiber kann dann ein Array von ModeCountD3DKMT_DISPLAYMODE Strukturen zuordnen, pModeList so festlegen, dass auf dieses Array verweist, und D3DKMTGetDisplayModeList erneut aufrufen, um die Anzeigemodusliste abzurufen.

Die Anzeigeattribute in der angegebenen VidPn-Quelle können zwischen diesen beiden Aufrufen geändert werden, wodurch die Anzeigemodusliste geändert wird. Wenn in diesem Fall das vom Aufrufer bereitgestellte D3DKMT_DISPLAYMODE Array nicht groß genug ist, um die neue Anzeigemodusliste zu enthalten, gibt diese Funktion STATUS_BUFFER_TOO_SMALL mit der Anzahl der neuen Anzeigemodi im zurückgegebenen ModeCount zurück. Der Aufrufer kann das vorherige D3DKMT_DISPLAYMODE Array freigeben, ein neues D3DKMT_DISPLAYMODE Array basierend auf der neuen zurückgegebenen Nummer zuordnen und diese Funktion erneut mit der neuen Nummer und dem neuen D3DKMT_DISPLAYMODE Array aufrufen, um die neue Anzeigemodusliste abzurufen.

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_DISPLAYMODE

D3DKMT_GETDISPLAYMODELIST