DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Die pfnGetAdditionalMonitorModeSet-Funktion gibt ein Handle für ein zusätzliches Monitor-Quellmodussatzobjekt 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, das einen Anzeigeadapter identifiziert. Das Microsoft DirectX-Grafikkernsubsystem hat dieses Handle zuvor für den Anzeigeminiporttreiber im DxgkInterface-Parameter der DxgkDdiStartDevice-Funktion bereitgestellt.

[in] VideoPresentTargetId

Eine ganze Zahl, die eines der Videoziele identifiziert, die auf der Grafikkarte vorhanden sind. Das zurückgegebene PpAdditionalModesSet-Objekt für zusätzliche Modi beschreibt die zusätzlichen Monitor-Quellmodussätze, die auf dem Monitor verfügbar sind, der mit diesem Videoobjekt verbunden ist.

[out] pNumberModes

Ein Zeiger auf eine Variable, die die Anzahl der zusätzlichen Zeitsteuerungsmodi des von VideoPresentTargetId angegebenen Videopräsentationsziels enthält.

[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 Zeitsteuerungsmodi eines Video präsentieren-Ziels, 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 wurde erfolgreich ausgeführt.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	Das in hAdapter angegebene 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 von VideoPresentTargetId identifizierten Videopräsentationsziel verbunden.
STATUS_NOT_FOUND	Das von VideoPresentTargetId identifizierte Videoziel konnte nicht gefunden werden.

Hinweise

VidPN-Zielbezeichner werden vom Anzeigeminiporttreiber zugewiesen. Die DxgkDdiQueryChildRelations-Funktion , die vom Anzeigeminiporttreiber 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.