DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO función de devolución de llamada (d3dkmddi.h)

La función pfnAcquireNextDescriptorInfo devuelve el siguiente descriptor en un conjunto de descriptores de supervisión, dado el descriptor actual.

Sintaxis

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

Parámetros

[in] hMonitorDescriptorSet

Identificador de un objeto de conjunto de descriptores de supervisión. El controlador de miniporte de pantalla obtuvo previamente este identificador llamando a la función pfnGetMonitorDescriptorSet de la interfaz Monitor.

[in] pMonitorDescriptorInfo

Puntero a una estructura D3DKMDT_MONITOR_DESCRIPTOR que es el descriptor actual. El controlador de miniporte para mostrar obtuvo previamente este puntero llamando a pfnAcquireFirstDescriptorInfo o pfnAcquireNextDescriptorInfo.

[out] ppNextMonitorDescriptorInfo

Puntero a una variable que recibe un puntero a una estructura D3DKMDT_MONITOR_DESCRIPTOR. La estructura es el siguiente descriptor del conjunto.

Valor devuelto

La función pfnAcquireNextDescriptorInfo devuelve uno de los siguientes valores.

Código devuelto	Descripción
STATUS_SUCCESS	La función devolvió correctamente el siguiente descriptor en el conjunto.
STATUS_GRAPHICS_NO_MORE_ELEMENTS_IN_DATASET	La función se realizó correctamente, pero no había más descriptores en el conjunto.
STATUS_INVALID_PARAMETER	Se proporcionó un parámetro no válido.
STATUS_INVALID_MONITOR_DESCRIPTOR	El descriptor proporcionado en pMonitorDescriptorInfo no era válido.
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET	El identificador proporcionado en hMonitorDescriptorSet no era válido.

Observaciones

Cuando haya terminado de usar la estructura D3DKMDT_MONITOR_DESCRIPTOR, debe liberar la estructura llamando a pfnReleaseDescriptorInfo.

Puede obtener todos los descriptores de un conjunto de descriptores de supervisión llamando a pfnAcquireFirstDescriptorInfo y, a continuación, realizando una secuencia de llamadas a pfnAcquireNextDescriptorInfo.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
de la plataforma de destino de	Escritorio
encabezado de	d3dkmddi.h (incluya D3dkmddi.h)
irQL	PASSIVE_LEVEL