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

A função pfnAcquireNextModeInfo retorna um descritor do próximo modo em um conjunto de modo de origem VidPN especificado, considerando o modo atual.

Sintaxe

DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpnsourcemodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in]  IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppNextVidPnSourceModeInfo
)
{...}

Parâmetros

[in] hVidPnSourceModeSet

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

[in] pVidPnSourceModeInfo

Um ponteiro para uma estrutura D3DKMDT_VIDPN_SOURCE_MODE que descreve o modo atual. O driver de miniporto de exibição obteve anteriormente esse ponteiro chamando pfnAcquireFirstModeInfo ou pfnAcquireNextModeInfo.

[out] ppNextVidPnSourceModeInfo

Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_VIDPN_SOURCE_MODE que descreve o próximo modo.

Retornar valor

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

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

Comentários

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

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

O tipo de dados D3DKMDT_HVIDPNSOURCEMODESET é 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_VIDPN_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnReleaseModeInfo