DXGKDDI_VIDPNTARGETMODESET_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 destino VidPN especificado.

Sintaxe

DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpntargetmodesetAcquirefirstmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetAcquirefirstmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppFirstVidPnTargetModeInfo
)
{...}

Parâmetros

[in] hVidPnTargetModeSet

Um identificador para um objeto de conjunto de modo de destino VidPN. O driver de miniporto de exibição obteve esse identificador anteriormente chamando a função pfnAcquireTargetModeSet da interface DXGK_VIDPN_INTERFACE .

[out] ppFirstVidPnTargetModeInfo

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

Valor retornado

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_VIDPN_TARGETMODESET O identificador fornecido em hVidPnTargetModeSet era inválido.

Comentários

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

Você pode enumerar todos os modos que pertencem a um objeto de conjunto de modo de destino VidPN chamando pfnAcquireFirstModeInfo e fazendo uma sequência de chamadas para pfnAcquireNextModeInfo.

Requisitos

   
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Desktop
Cabeçalho d3dkmddi.h (include D3dkmddi.h)
IRQL PASSIVE_LEVEL

Confira também

D3DKMDT_VIDPN_TARGET_MODE

pfnAcquireNextModeInfo

pfnReleaseModeInfo