DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET função de retorno de chamada (d3dkmddi.h)
A função pfnGetMonitorDescriptorSet retorna um identificador para um objeto de conjunto de descritores de monitor associado a um monitor especificado.
Sintaxe
DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET DxgkddiMonitorGetmonitordescriptorset;
NTSTATUS DxgkddiMonitorGetmonitordescriptorset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORDESCRIPTORSET phMonitorDescriptorSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORDESCRIPTORSET_INTERFACE ppMonitorDescriptorSetInterface
)
{...}
Parâmetros
[in] hAdapter
Um identificador que identifica um adaptador de exibição. O subsistema de kernel de gráficos do Microsoft DirectX previamente forneceu esse identificador para o driver de miniporto de exibição no parâmetro DxgkInterface da função DxgkDdiStartDevice .
[in] VideoPresentTargetId
Um inteiro que identifica um dos destinos de vídeo presentes no adaptador de exibição. O objeto de conjunto de descritores de monitor retornado contém descritores para o monitor que está conectado a este destino de vídeo presente.
[out] phMonitorDescriptorSet
Um ponteiro para uma variável que recebe um identificador para um objeto de conjunto de descritores de monitor.
[out] ppMonitorDescriptorSetInterface
Um ponteiro para uma variável que recebe um ponteiro para uma estrutura DXGK_MONITORDESCRIPTORSET_INTERFACE . A estrutura contém ponteiros para funções que o driver de miniporto de exibição pode chamar para inspecionar e alterar o objeto de conjunto de descritores do monitor.
Retornar valor
A função pfnGetMonitorDescriptorSet retorna um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | A função foi bem-sucedida. |
| STATUS_INVALID_PARAMETER | Um parâmetro inválido foi fornecido. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | O identificador fornecido no hAdapter era inválido. |
| STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET | O identificador fornecido em VideoPresentTargetId era inválido. |
| STATUS_GRAPHICS_MONITOR_NOT_CONNECTED | Não há nenhum monitor conectado ao destino presente do vídeo identificado por VideoPresentTargetId. |
Comentários
Os identificadores de destino VidPN são atribuídos pelo driver de miniporta de exibição. A função DxgkDdiQueryChildRelations , implementada pelo driver de miniporto de exibição, retorna uma matriz de estruturas DXGK_CHILD_DESCRIPTOR , cada uma contendo um identificador.
Você não precisa liberar o identificador retornado em phMonitorDescriptorSet.
Essa função também está disponível na interface DXGK_MONITOR_INTERFACE_V2 começando com o Windows 7.
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 |