DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET Rückruffunktion (d3dkmddi.h)
Die pfnAcquireMonitorSourceModeSet--Funktion gibt ein Handle an das Set-Objekt des Monitorquellmodus 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, 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 Quellmodussatzobjekt 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 Monitorquellmodus-Set-Objekt 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 Monitor-Quellmodus zu prüfen und zu ändern.
Rückgabewert
Die pfnAcquireMonitorSourceModeSet Funktion gibt einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion war erfolgreich. |
| 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 DxgkDdiQueryChildRelations--Funktion, die vom Display Miniporttreiber implementiert wird, gibt ein Array 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 pfnReleaseMonitorSourceModeSetaufrufen. Zielmodussatzobjekte werden gezählt. Wenn Sie also mehrere Male ein Handle abrufen, müssen Sie es beliebig oft 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 |