Compartilhar via

DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO função de retorno de chamada (d3dkmddi.h)

  • Artigo

A função pfnAcquireNextDescriptorInfo retorna o próximo descritor em um conjunto de descritores de monitor, dado o descritor atual.

Sintaxe

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

Um identificador para um objeto de conjunto de descritores de monitor. O driver de miniporto de exibição obteve esse identificador anteriormente chamando a função pfnGetMonitorDescriptorSet da interface Monitor.

[in] pMonitorDescriptorInfo

Um ponteiro para uma estrutura D3DKMDT_MONITOR_DESCRIPTOR que é o descritor atual. O driver de miniporte de exibição obteve esse ponteiro anteriormente chamando pfnAcquireFirstDescriptorInfo ou pfnAcquireNextDescriptorInfo.

[out] ppNextMonitorDescriptorInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_MONITOR_DESCRIPTOR . A estrutura é o próximo descritor no conjunto.

Retornar valor

A função pfnAcquireNextDescriptorInfo retorna um dos valores a seguir.

Código de retorno Descrição
STATUS_SUCCESS A função retornou com êxito o próximo descritor no conjunto.
STATUS_GRAPHICS_NO_MORE_ELEMENTS_IN_DATASET A função foi bem-sucedida, mas não havia mais descritores no conjunto.
STATUS_INVALID_PARAMETER Um parâmetro inválido foi fornecido.
STATUS_INVALID_MONITOR_DESCRIPTOR O descritor fornecido em pMonitorDescriptorInfo era inválido.
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET O identificador fornecido em hMonitorDescriptorSet era inválido.

Comentários

Quando terminar de usar a estrutura D3DKMDT_MONITOR_DESCRIPTOR, você deverá liberar a estrutura chamando pfnReleaseDescriptorInfo.

Você pode obter todos os descritores em um descritor de monitor definido chamando pfnAcquireFirstDescriptorInfo e, em seguida, fazendo uma sequência de chamadas para pfnAcquireNextDescriptorInfo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho d3dkmddi.h (inclua D3dkmddi.h)
IRQL PASSIVE_LEVEL