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, 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 Monitordeskriptorsatzobjekt 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 Display-Miniporttreiber aufrufen kann, um das Monitordeskriptorsatzobjekt zu prüfen und zu ändern.
Rückgabewert
Die pfnGetMonitorDescriptorSet Funktion gibt einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion war erfolgreich. |
| STATUS_INVALID_PARAMETER | Es wurde ein ungültiger Parameter angegeben. |
| 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. |
Bemerkungen
VidPN-Ziel-IDs werden vom Anzeigeminiporttreiber zugewiesen. Die DxgkDdiQueryChildRelations Funktion, die vom Display miniport-Treiber implementiert wird, gibt ein Array von DXGK_CHILD_DESCRIPTOR Strukturen zurück, die jeweils einen Bezeichner enthalten.
Sie müssen das in phMonitorDescriptorSetzurückgegebene Handle nicht 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 |