DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET Rückruffunktion (d3dkmddi.h)
Die pfnGetMonitorFrequencyRangeSet Funktion gibt ein Handle für das Monitorfrequenzbereichssatzobjekt 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, 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 Monitorfrequenzbereichssatzobjekt beschreibt die Frequenzbereiche, die auf dem Monitor verfügbar sind, der mit diesem Videoobjekt verbunden ist.
[out] phMonitorFrequencyRangeSet
Ein Zeiger auf eine Variable, die ein Handle für das Monitorfrequenzbereichssatzobjekt 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 Display-Miniporttreiber aufrufen kann, um das Festgelegt-Objekt des Monitorfrequenzbereichs zu prüfen und zu ändern.
Rückgabewert
Die funktion pfnGetMonitorFrequencyRangeSet gibt einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion war erfolgreich. |
| STATUS_INVALID_PARAMETER | Es wurde ein ungültiger Parameter angegeben. |
| 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. |
Diese Funktion gibt möglicherweise auch andere Fehlercodes zurück, die in Ntstatus.hdefiniert sind.
Bemerkungen
VidPN-Ziel-IDs werden vom Anzeigeminiporttreiber zugewiesen. Die DxgkDdiQueryChildRelationsFunktion, die vom Display miniport-Treiber implementiert wird, gibt ein Array von DXGK_CHILD_DESCRIPTOR Strukturen zurück, die jeweils einen Bezeichner enthalten.
Sie müssen den in phMonitorFrequencyRangeSetzurückgegebenen Handle nicht freigeben.
Diese Funktion steht auch in der DXGK_MONITOR_INTERFACE_V2 Schnittstelle ab Windows 7 zur Verfügung.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |