DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnGetMonitorFrequencyRangeSet-Funktion gibt ein Handle für das Objekt des Monitorfrequenzbereichssatz zurück, das einem angegebenen Monitor zugeordnet ist.

Syntax

DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET DxgkddiMonitorGetmonitorfrequencyrangeset;

NTSTATUS DxgkddiMonitorGetmonitorfrequencyrangeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORFREQUENCYRANGESET phMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORFREQUENCYRANGESET_INTERFACE ppMonitorFrequencyRangeSetInterface
)
{...}

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 Objekt für den Monitorfrequenzbereichssatz beschreibt die auf dem Monitor verfügbaren Frequenzbereiche, der mit diesem Videoobjekt verbunden ist.

[out] phMonitorFrequencyRangeSet

Ein Zeiger auf eine Variable, die ein Handle auf das Objekt des Monitorfrequenzbereichssatz empfängt.

[out] ppMonitorFrequencyRangeSetInterface

Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_MONITORFREQUENCYRANGESET_INTERFACE-Struktur empfängt. Die Struktur enthält Zeiger auf Funktionen, die der Anzeigeminiporttreiber aufrufen kann, um das Monitorfrequenzbereichssatzobjekt zu überprüfen und zu ändern.

Rückgabewert

Die PfnGetMonitorFrequencyRangeSet-Funktion gibt einen der folgenden Werte zurück.

Rückgabecode Beschreibung
STATUS_SUCCESS Die Funktion wurde erfolgreich ausgeführt.
STATUS_INVALID_PARAMETER Ein ungültiger Parameter wurde angegeben.
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.

Diese Funktion kann auch andere Fehlercodes zurückgeben, die in Ntstatus.h definiert sind.

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.

Sie müssen das in phMonitorFrequencyRangeSet zurückgegebene Handle nicht freigeben.

Diese Funktion ist auch in der DXGK_MONITOR_INTERFACE_V2-Schnittstelle ab Windows 7 verfügbar.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Zielplattform Desktop
Kopfzeile d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality