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.

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

Confira também

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality