Função D3DKMTGetDisplayModeList (d3dkmthk.h)

A função D3DKMTGetDisplayModeList recupera uma lista de modos de exibição disponíveis, incluindo modos com formato estendido.

Sintaxe

NTSTATUS D3DKMTGetDisplayModeList(
  D3DKMT_GETDISPLAYMODELIST *unnamedParam1
);

Parâmetros

unnamedParam1

[in/out] pData é um ponteiro para uma estrutura D3DKMT_GETDISPLAYMODELIST que contém os argumentos para essa função.

Valor de retorno

D3DKMTGetDisplayModeList retorna um valor de NTSTATUS , como um dos seguintes.

Código de retorno	descrição
STATUS_SUCCESS	A lista de modos de exibição disponíveis foi recuperada com êxito ou o número de modos de exibição foi retornado em >ModeCount se pData->pModeList fosse NULL e pData->ModeCount era zero na entrada.
STATUS_DEVICE_REMOVED	O adaptador gráfico foi interrompido.
STATUS_BUFFER_TOO_SMALL	O buffer fornecido pelo driver cliente em pData-> pModeList não é grande o suficiente para conter a lista de modos de exibição solicitada.
STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET	Nenhum destino presente em vídeo está disponível para uso com a fonte presente do vídeo identificada por pData->VidPnSourceId. Portanto, nenhum modo de exibição está disponível para essa origem.
STATUS_INVALID_PARAMETER**	Os parâmetros foram validados e determinados como incorretos.

Observações

Para obter o número dos modos de exibição para a origem VidPn especificada (pData->VidPnSourceId) no adaptador gráfico (pData->hAdapter), a O driver cliente pode chamar D3DKMTGetDisplayModeList com pData->pModeList definido como NULL e pData->ModeCount como 0. Se essa chamada retornar STATUS_SUCCESS, o ModeCounté o número total dos modos de exibição. Em seguida, o driver cliente pode alocar uma matriz de estruturas ModeCountD3DKMT_DISPLAYMODE, definir pModeList para apontar para essa matriz e chamar D3DKMTGetDisplayModeList novamente para recuperar a lista de modos de exibição.

Os atributos de exibição na origem VidPn especificada podem ser alterados entre essas duas chamadas, fazendo com que a lista de modo de exibição seja alterada. Nesse caso, se a matriz de D3DKMT_DISPLAYMODE fornecida pelo chamador não for grande o suficiente para manter a nova lista de modos de exibição, essa função retornará STATUS_BUFFER_TOO_SMALL com o número dos novos modos de exibição no modeCount retornado. O chamador pode liberar a matriz de D3DKMT_DISPLAYMODE anterior, alocar uma nova matriz de D3DKMT_DISPLAYMODE com base no novo número retornado e chamar essa função novamente com o novo número e a nova matriz de D3DKMT_DISPLAYMODE para obter a nova lista de modos de exibição.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Universal
cabeçalho	d3dkmthk.h (inclua D3dkmthk.h)
biblioteca	Gdi32.lib
de DLL	Gdi32.dll

Consulte também

D3DKMT_DISPLAYMODE

D3DKMT_GETDISPLAYMODELIST