DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/26/2024

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 Monitordeskriptor-Set-Objekt. Der Anzeige-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnGetMonitorDescriptorSet-Funktion der Monitor-Schnittstelle abgerufen.

[in] pMonitorDescriptorInfo

Ein Zeiger auf eine D3DKMDT_MONITOR_DESCRIPTOR-Struktur , bei der es sich um den aktuellen Deskriptor handelt. Der Anzeige-Miniporttreiber hat diesen Zeiger zuvor durch Aufrufen von pfnAcquireFirstDescriptorInfo oder pfnAcquireNextDescriptorInfo abgerufen.

[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 im Satz.

Rückgabewert

Die PfnAcquireNextDescriptorInfo-Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion hat erfolgreich den nächsten Deskriptor im Satz 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 angegebene Deskriptor war ungültig.
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET	Das in hMonitorDescriptorSet angegebene Handle war ungültig.

Hinweise

Wenn Sie die Verwendung der D3DKMDT_MONITOR_DESCRIPTOR-Struktur abgeschlossen haben, müssen Sie die -Struktur freigeben, indem Sie pfnReleaseDescriptorInfo aufrufen.

Sie können alle Deskriptoren in einem festgelegten Monitordeskriptor abrufen, indem Sie pfnAcquireFirstDescriptorInfo aufrufen und dann eine Sequenz von Aufrufen von pfnAcquireNextDescriptorInfo ausführen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Freigeben über