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 wie einen der folgenden zurück.
| 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 war und pData->ModeCount für eingabe null war. |
| STATUS_DEVICE_REMOVED | Der 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 video present-Quelle, die durch pData->VidPnSourceId-identifiziert wird, ist kein Ziel vorhanden. Daher sind keine Anzeigemodi für diese Quelle verfügbar. |
| STATUS_INVALID_PARAMETER** | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
Bemerkungen
So rufen Sie die Anzahl der Anzeigemodi für die angegebene VidPn-Quelle (pData->VidPnSourceId) auf dem Grafikkartenadapter (pData->hAdapter), einem Clienttreiber kann D3DKMTGetDisplayModeList- mit pData->pModeList- auf NULL festgelegt und pData->ModeCount als 0 festgelegt werden. Wenn dieser Aufruf STATUS_SUCCESS zurückgibt, ist der zurückgegebene pData->ModeCount die Gesamtanzahl der Anzeigemodi. Der Clienttreiber kann dann ein Array von ModeCount-D3DKMT_DISPLAYMODE Strukturen zuordnen, pModeList- auf dieses Array verweisen, und D3DKMTGetDisplayModeList erneut aufrufen, um die Liste des Anzeigemodus abzurufen.
Die Anzeigeattribute 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 halten, gibt diese Funktion STATUS_BUFFER_TOO_SMALL mit der Anzahl der neuen Anzeigemodi im zurückgegebenen ModeCountzurück. Der Aufrufer kann das vorherige D3DKMT_DISPLAYMODE Array freigeben, ein neues D3DKMT_DISPLAYMODE Array basierend auf der neuen zurückgegebenen Nummer zuweisen und diese Funktion erneut mit der neuen Nummer und dem neuen D3DKMT_DISPLAYMODE Array aufrufen, um die neue Anzeigemodusliste abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Universal |
| Header- | d3dkmthk.h (einschließlich D3dkmthk.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |