DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET Rückruffunktion (d3dkmddi.h)

Artikel
2025-02-06

Die pfnGetAdditionalMonitorModeSet--Funktion gibt ein Handle an ein zusätzliches Monitorquellenmodussatzobjekt zurück, das einem angegebenen Monitor zugeordnet ist. Sie ist ab Windows 7 in der DXGK_MONITOR_INTERFACE_V2-Schnittstelle verfügbar.

Syntax

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

Parameter

[in] hAdapter

Ein Handle, der einen Anzeigeadapter identifiziert. Das Microsoft DirectX-Grafik-Kernelsubsystem hat dieses Handle zuvor dem Anzeigeminiporttreiber im DxgkInterface- Parameter der DxgkDdiStartDevice--Funktion bereitgestellt.

[in] VideoPresentTargetId

Eine ganze Zahl, die einen der Videodaten identifiziert, die auf dem Grafikkartenziel vorhanden sind. Das zurückgegebene ppAdditionalModesSet zusätzliche Modi-Set-Objekt beschreibt die zusätzlichen Monitorquellmodussätze, die auf dem Monitor verfügbar sind, der mit diesem Videoobjekt verbunden ist.

[out] pNumberModes

Ein Zeiger auf eine Variable, die die Anzahl zusätzlicher Anzeigemodi des Videopräsentationsziels enthält, das durch VideoPresentTargetIdangegeben wird.

[out] ppAdditionalModesSet

Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_TARGETMODE_DETAIL_TIMING Struktur empfängt. Die Struktur beschreibt die zusätzlichen Anzeigemodi eines Videos, die mit dem Anzeigegerät kompatibel sind.

Rückgabewert

Die pfnAcquireMonitorSourceModeSet Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	Der in hAdapter bereitgestellte Handle war ungültig.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	Der in VideoPresentTargetId angegebene Bezeichner war ungültig.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	Es ist kein Monitor mit dem video present-Ziel verbunden, das von VideoPresentTargetId identifiziert wird.
STATUS_NOT_FOUND	Das von VideoPresentTargetId identifizierte Videopräsentationsziel konnte nicht gefunden werden.

Bemerkungen

VidPN-Ziel-IDs werden vom Anzeigeminiporttreiber zugewiesen. Die DxgkDdiQueryChildRelations Funktion, die vom Display miniport-Treiber implementiert wird, gibt ein Array von DXGK_CHILD_DESCRIPTOR Strukturen zurück, die jeweils einen Bezeichner enthalten.

Diese Funktion ist ab Windows 7 verfügbar.