Compartilhar via


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

A função pfnAcquireFirstModeInfo retorna um descritor do primeiro modo em um conjunto de modo de origem do monitor especificado.

Sintaxe

DXGKDDI_MONITORSOURCEMODESET_ACQUIREFIRSTMODEINFO DxgkddiMonitorsourcemodesetAcquirefirstmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirefirstmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppFirstMonitorSourceModeInfo
)
{...}

Parâmetros

[in] hMonitorSourceModeSet

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

[out] ppFirstMonitorSourceModeInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_MONITOR_SOURCE_MODE . A estrutura contém uma variedade de informações sobre o modo de origem do monitor, incluindo suas características de ID e sinal de vídeo.

Retornar valor

A função pfnAcquireFirstModeInfo retorna um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS A função foi bem-sucedida.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET O identificador fornecido em hMonitorSourceModeSet era inválido.

Comentários

Quando terminar de usar a estrutura D3DKMDT_MONITOR_SOURCE_MODE , você deverá liberar a estrutura chamando pfnReleaseModeInfo.

Você pode enumerar todos os modos que pertencem a um objeto definido do modo de origem do monitor VidPN chamando pfnAcquireFirstModeInfo e, em seguida, fazendo uma sequência de chamadas para pfnAcquireNextModeInfo.

O tipo de dados D3DKMDT_HMONITORSOURCEMODESET é definido em D3dkmdt.h.

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

Confira também

D3DKMDT_MONITOR_SOURCE_MODE

pfnAcquireNextModeInfo

pfnReleaseModeInfo