Compartilhar via

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

  • Artigo

A função pfnAcquireFirstDescriptorInfo retorna o primeiro descritor em um objeto de conjunto de descritores de monitor.

Sintaxe

DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo;

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

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.

[out] ppFirstMonitorDescriptorInfo

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

Retornar valor

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

Código de retorno Descrição
STATUS_SUCCESS A função retornou com êxito o primeiro descritor no conjunto.
STATUS_GRAPHICS_DATASET_IS_EMPTY A função foi bem-sucedida, mas não havia descritores no conjunto.
STATUS_INVALID_PARAMETER Um parâmetro inválido foi fornecido.
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