DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO funzione di callback (d3dkmddi.h)

Articolo
05/26/2023

La funzione pfnAcquireFirstDescriptorInfo restituisce il primo descrittore in un oggetto set di descrittori di monitoraggio.

Sintassi

DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo;

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

Parametri

[in] hMonitorDescriptorSet

Handle per un oggetto set di descrittori di monitoraggio. Il driver miniport di visualizzazione ottenuto in precedenza questo handle chiamando la funzione pfnGetMonitorDescriptorSet dell'interfaccia Monitor.

[out] ppFirstMonitorDescriptorInfo

Puntatore a una variabile che riceve un puntatore a una struttura D3DKMDT_MONITOR_DESCRIPTOR . La struttura è il primo descrittore nel set.

Valore restituito

La funzione pfnAcquireFirstDescriptorInfo restituisce uno dei valori seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha restituito correttamente il primo descrittore nel set.
STATUS_GRAPHICS_DATASET_IS_EMPTY	La funzione ha avuto esito positivo, ma non sono presenti descrittori nel set.
STATUS_INVALID_PARAMETER	È stato fornito un parametro non valido.
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET	L'handle fornito in hMonitorDescriptorSet non è valido.

Commenti

Al termine dell'uso della struttura D3DKMDT_MONITOR_DESCRIPTOR, è necessario rilasciare la struttura chiamando pfnReleaseDescriptorInfo.

È possibile ottenere tutti i descrittori in un set di descrittori di monitoraggio chiamando pfnAcquireFirstDescriptorInfo e quindi eseguendo una sequenza di chiamate a pfnAcquireNextDescriptorInfo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Piattaforma di destinazione	Desktop
Intestazione	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Condividi tramite