DXGKDDI_MONITORSOURCEMODESET_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 do monitor especificado, considerando o modo atual.
Sintaxe
DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiMonitorsourcemodesetAcquirenextmodeinfo;
NTSTATUS DxgkddiMonitorsourcemodesetAcquirenextmodeinfo(
[in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
[in] IN_CONST_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppNextMonitorSourceModeInfo
)
{...}
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 atual. O driver de miniporto de exibição obteve anteriormente esse ponteiro chamando pfnAcquireFirstModeInfo ou pfnAcquireNextModeInfo.
[out] ppNextMonitorSourceModeInfo
Um ponteiro para uma variável que recebe um ponteiro para uma estrutura D3DKMDT_MONITOR_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_MONITOR_SOURCEMODESET | O identificador fornecido em hMonitorSourceModeSet era inválido. |
Comentários
Quando terminar de usar a estrutura D3DKMDT_MONITOR_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 do monitor específico chamando pfnAcquireFirstModeInfo e, em seguida, fazendo uma sequência de chamadas para pfnAcquireNextModeInfo.
O tipo de dados D3DKMDT_HMONITORSOURCEMODESET é 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 |