DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnAcquireNextDescriptorInfo Funktion gibt den nächsten Deskriptor in einem Monitordeskriptorsatz zurück, wenn der aktuelle Deskriptor angegeben ist.

Syntax

DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo;

NTSTATUS DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_DESCRIPTOR_CONST pMonitorDescriptorInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppNextMonitorDescriptorInfo
)
{...}

Parameter

[in] hMonitorDescriptorSet

Ein Handle für ein Monitordeskriptorsatzobjekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnGetMonitorDescriptorSet- Funktion der Monitorschnittstelleabgerufen.

[in] pMonitorDescriptorInfo

Ein Zeiger auf eine D3DKMDT_MONITOR_DESCRIPTOR Struktur, die der aktuelle Deskriptor ist. Der Display-Miniporttreiber hat diesen Zeiger zuvor durch Aufrufen pfnAcquireFirstDescriptorInfo oder pfnAcquireNextDescriptorInfoabgerufen.

[out] ppNextMonitorDescriptorInfo

Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_MONITOR_DESCRIPTOR Struktur empfängt. Die Struktur ist der nächste Deskriptor in der Gruppe.

Rückgabewert

Die pfnAcquireNextDescriptorInfo Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion hat den nächsten Deskriptor in der Gruppe erfolgreich zurückgegeben.
STATUS_GRAPHICS_NO_MORE_ELEMENTS_IN_DATASET	Die Funktion war erfolgreich, aber es gab keine weiteren Deskriptoren in der Gruppe.
STATUS_INVALID_PARAMETER	Es wurde ein ungültiger Parameter angegeben.
STATUS_INVALID_MONITOR_DESCRIPTOR	Der in pMonitorDescriptorInfo bereitgestellte Deskriptor war ungültig.
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET	Das in hMonitorDescriptorSet bereitgestellte Handle war ungültig.

Bemerkungen

Wenn Sie die D3DKMDT_MONITOR_DESCRIPTOR Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseDescriptorInfoaufrufen.

Sie können alle Deskriptoren in einem Monitordeskriptor abrufen, der festgelegt ist, indem Sie pfnAcquireFirstDescriptorInfo aufrufen und dann eine Abfolge von Aufrufen an pfnAcquireNextDescriptorInfo.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL-	PASSIVE_LEVEL

Freigeben über