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

A função pfnAcquireMonitorSourceModeSet retorna um identificador para o objeto de conjunto de modo de origem do monitor associado a um monitor especificado.

Sintaxe

DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET DxgkddiMonitorAcquiremonitorsourcemodeset;

NTSTATUS DxgkddiMonitorAcquiremonitorsourcemodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORSOURCEMODESET phMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORSOURCEMODESET_INTERFACE ppMonitorSourceModeSetInterface
)
{...}

Parâmetros

[in] hAdapter

Um identificador que identifica um adaptador de exibição. O subsistema de kernel de gráficos do Microsoft DirectX previamente forneceu esse identificador para o driver de miniporto de exibição no parâmetro DxgkInterface da função DxgkDdiStartDevice .

[in] VideoPresentTargetId

Um inteiro que identifica um dos destinos de vídeo presentes no adaptador de exibição. O objeto de conjunto de modo de origem retornado descreve os modos disponíveis no monitor que está conectado a este destino de vídeo presente.

[out] phMonitorSourceModeSet

Um ponteiro para uma variável que recebe um identificador para um objeto de conjunto de modo de origem do monitor.

[out] ppMonitorSourceModeSetInterface

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura DXGK_MONITORSOURCEMODESET_INTERFACE . A estrutura contém ponteiros para funções que o driver de miniporto de exibição pode chamar para inspecionar e alterar o objeto de conjunto do modo de origem do monitor.

Retornar valor

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

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	O identificador fornecido no hAdapter era inválido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	O identificador fornecido em VideoPresentTargetId era inválido.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	Não há nenhum monitor conectado ao destino presente do vídeo identificado por VideoPresentTargetId.

Essa função também pode retornar outros códigos de erro definidos em Ntstatus.h.

Comentários

Os identificadores de destino VidPN são atribuídos pelo driver de miniporta de exibição. A função DxgkDdiQueryChildRelations , implementada pelo driver de miniporto de exibição, retorna uma matriz de estruturas DXGK_CHILD_DESCRIPTOR , cada uma contendo um identificador.

Quando terminar de usar o identificador de objeto do conjunto de modo de origem do monitor, você deverá liberar o identificador chamando pfnReleaseMonitorSourceModeSet. Os objetos de conjunto de modo de destino são contados por referência, portanto, se você adquirir um identificador várias vezes, deverá liberá-lo no mesmo número de vezes.

Essa função também está disponível na interface DXGK_MONITOR_INTERFACE_V2 começando com o Windows 7.

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

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality