DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO funzione di callback (d3dkmddi.h)

La funzione pfnAcquireNextDescriptorInfo restituisce il descrittore successivo in un set di descrittori di monitoraggio, dato il descrittore corrente.

Sintassi

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
)
{...}

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 pfnGetMonitorDescriptorSetdell'interfaccia Monitor.

[in] pMonitorDescriptorInfo

Puntatore a una struttura D3DKMDT_MONITOR_DESCRIPTOR che rappresenta il descrittore corrente. Il driver miniport di visualizzazione precedentemente ottenuto questo puntatore chiamando pfnAcquireFirstDescriptorInfo o pfnAcquireNextDescriptorInfo.

[out] ppNextMonitorDescriptorInfo

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

Valore restituito

La funzione pfnAcquireNextDescriptorInfo restituisce uno dei valori seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha restituito correttamente il descrittore successivo nel set.
STATUS_GRAPHICS_NO_MORE_ELEMENTS_IN_DATASET	La funzione ha avuto esito positivo, ma non sono presenti più descrittori nel set.
STATUS_INVALID_PARAMETER	È stato fornito un parametro non valido.
STATUS_INVALID_MONITOR_DESCRIPTOR	Il descrittore fornito in pMonitorDescriptorInfo 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