DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET Rückruffunktion (d3dkmddi.h)
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 |