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

  • Artigo

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 miniporta 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 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.

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_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, em seguida, fazendo uma sequência de chamadas para pfnAcquireNextModeInfo.

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_VIDPN_TARGET_MODE

pfnAcquireNextModeInfo

pfnReleaseModeInfo