DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die pfnAcquireFirstDescriptorInfo Funktion gibt den ersten Deskriptor in einem Monitordeskriptorsatzobjekt zurück.

Syntax

DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo;

NTSTATUS DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppFirstMonitorDescriptorInfo
)
{...}

Parameter

[in] hMonitorDescriptorSet

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

[out] ppFirstMonitorDescriptorInfo

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

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion hat den ersten Deskriptor in der Gruppe erfolgreich zurückgegeben.
STATUS_GRAPHICS_DATASET_IS_EMPTY	Die Funktion war erfolgreich, aber es gab keine Deskriptoren in der Gruppe.
STATUS_INVALID_PARAMETER	Es wurde ein ungültiger Parameter angegeben.
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