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

  • Artículo

La función pfnAcquireNextDescriptorInfo devuelve el siguiente descriptor en un conjunto de descriptores de monitor, 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 anteriormente 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 de pantalla 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 valores siguientes.

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.

Comentarios

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 Value
Cliente mínimo compatible Windows Vista
Plataforma de destino Escritorio
Encabezado d3dkmddi.h (incluye D3dkmddi.h)
IRQL PASSIVE_LEVEL