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

A função pfnAddMode adiciona um modo de origem do monitor a um objeto de conjunto de modo de origem do monitor especificado.

Sintaxe

DXGKDDI_MONITORSOURCEMODESET_ADDMODE DxgkddiMonitorsourcemodesetAddmode;

NTSTATUS DxgkddiMonitorsourcemodesetAddmode(
  [in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in] IN_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo
)
{...}

Parâmetros

[in] hMonitorSourceModeSet

Um identificador para um objeto de conjunto de modo de origem do monitor. O driver de miniporta de exibição obteve esse identificador anteriormente chamando a função pfnAcquireMonitorSourceModeSet da interface Monitor.

[in] pMonitorSourceModeInfo

Um ponteiro para uma estrutura D3DKMDT_MONITOR_SOURCE_MODE que descreve o modo de origem do monitor. O driver de miniporto de exibição obteve essa estrutura anteriormente chamando pfnCreateNewModeInfo.

Retornar valor

A função pfnAddMode retorna um dos valores a seguir.

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_NO_MEMORY	A função falhou porque não pôde alocar memória suficiente.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCE_MODE	As informações fornecidas em pMonitorSourceModeInfo eram inválidas.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	O identificador fornecido em hMonitorSourceModeSet era inválido.
STATUS_GRAPHICS_INVALID_FREQUENCY	As informações de frequência fornecidas em pMonitorSourceModeInfo eram inválidas.
STATUS_GRAPHICS_INVALID_ACTIVE_REGION	A região ativa fornecida em pMonitorSourceModeInfo era inválida.
STATUS_GRAPHICS_INVALID_TOTAL_REGION	A região total fornecida em pMonitorSourceModeInfo era inválida.
STATUS_GRAPHICS_MODE_ALREADY_IN_MODE_SET	O conjunto de modos já contém um modo idêntico ao modo fornecido em pMonitorSourceModeInfo.
STATUS_GRAPHICS_MODE_ID_MUST_BE_UNIQUE	O identificador fornecido em pMonitorSourceModeInfo-Id> já está sendo usado para outro modo no conjunto de modos.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED	A estrutura apontada por pMonitorSourceModeInfo não foi criada para adição ao conjunto de modos especificado por hMonitorSourceModeSet.

Comentários

Se pMonitorSourceModeInfo-Preference> for igual a D3DKMDT_MP_PREFERRED, o modo recém-adicionado se tornará o modo preferencial do conjunto de modos.

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

pfnCreateNewModeInfo