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