DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnGetMonitorDescriptorSet-Funktion gibt ein Handle an ein Monitordeskriptorsatzobjekt zurück, das einem angegebenen Monitor zugeordnet ist.

Syntax

DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET DxgkddiMonitorGetmonitordescriptorset;

NTSTATUS DxgkddiMonitorGetmonitordescriptorset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORDESCRIPTORSET phMonitorDescriptorSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORDESCRIPTORSET_INTERFACE ppMonitorDescriptorSetInterface
)
{...}

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 des Monitordeskriptorsatzes enthält Deskriptoren für den Monitor, der mit diesem Videoobjekt verbunden ist.

[out] phMonitorDescriptorSet

Ein Zeiger auf eine Variable, die ein Handle für ein Monitordeskriptorsatzobjekt empfängt.

[out] ppMonitorDescriptorSetInterface

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

Rückgabewert

Die PfnGetMonitorDescriptorSet-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.

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 phMonitorDescriptorSet 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