DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnAcquireMonitorSourceModeSet-Funktion gibt ein Handle an das Objekt des Monitor-Quellmodussatz zurück, das einem angegebenen Monitor zugeordnet ist.

Syntax

DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET DxgkddiMonitorAcquiremonitorsourcemodeset;

NTSTATUS DxgkddiMonitorAcquiremonitorsourcemodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORSOURCEMODESET phMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORSOURCEMODESET_INTERFACE ppMonitorSourceModeSetInterface
)
{...}

Parameter

[in] hAdapter

Ein Handle, das eine Grafikkarte identifiziert. Das Microsoft DirectX-Grafikkernsubsystem hat dieses Handle zuvor für den Anzeige-Miniporttreiber 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 Quellmodus-Set-Objekt beschreibt die Modi, die auf dem Monitor verfügbar sind, der mit diesem Videoobjekt verbunden ist.

[out] phMonitorSourceModeSet

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

[out] ppMonitorSourceModeSetInterface

Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_MONITORSOURCEMODESET_INTERFACE-Struktur empfängt. Die -Struktur enthält Zeiger auf Funktionen, die der Anzeige-Miniporttreiber aufrufen kann, um das Set-Objekt des Monitorquellmodus zu überprüfen und zu ändern.

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 videogegenstigen Ziel verbunden, das durch VideoPresentTargetId identifiziert wird.

Diese Funktion gibt möglicherweise auch andere Fehlercodes zurück, die in Ntstatus.h definiert sind.

Hinweise

VidPN-Zielbezeichner werden vom Anzeige-Miniporttreiber zugewiesen. Die dxgkDdiQueryChildRelations-Funktion , die vom Anzeigeminiporttreiber implementiert wird, gibt ein Array von DXGK_CHILD_DESCRIPTOR Strukturen zurück, die jeweils einen Bezeichner enthalten.

Wenn Sie das Objekthandle für den Monitorquellmodus festgelegt haben, müssen Sie das Handle freigeben, indem Sie pfnReleaseMonitorSourceModeSet aufrufen. Zielmodus-Set-Objekte werden gezählt. Wenn Sie also ein Handle mehrmals abrufen, müssen Sie es genauso oft 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