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 miniporto de exibição obteve esse identificador anteriormente chamando a função pfnAcquireMonitorSourceModeSet da interface Monitor.
[in] pMonitorSourceModeInfo
Um ponteiro para uma estrutura de 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.
Valor de retorno
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 no pMonitorSourceModeInfo eram inválidas. |
| STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET | O identificador fornecido no hMonitorSourceModeSet era inválido. |
| STATUS_GRAPHICS_INVALID_FREQUENCY | As informações de frequência fornecidas no pMonitorSourceModeInfo eram inválidas. |
| STATUS_GRAPHICS_INVALID_ACTIVE_REGION | A região ativa fornecida no 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 no 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 pelo pMonitorSourceModeInfo não foi criada para adição ao conjunto de modos especificado por hMonitorSourceModeSet. |
Observações
Se pMonitorSourceModeInfo –> de preferência for igual a D3DKMDT_MP_PREFERRED, o modo recém-adicionado se tornará o modo preferencial do conjunto de modos.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h (inclua D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |