DXGKDDI_LINK_DEVICE função de retorno de chamada (dispmprt.h)
A função DxgkDdiLinkDevice opcional consulta o driver de miniporto de exibição para obter informações sobre a configuração do adaptador vinculado.
Sintaxe
DXGKDDI_LINK_DEVICE DxgkddiLinkDevice;
NTSTATUS DxgkddiLinkDevice(
[in] IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
[in] IN_CONST_PVOID MiniportDeviceContext,
[in, out] INOUT_PLINKED_DEVICE LinkedDevice
)
{...}
Parâmetros
[in] PhysicalDeviceObject
Um ponteiro para um PDO (objeto de dispositivo físico) que identifica um adaptador de exibição.
[in] MiniportDeviceContext
Um identificador para um bloco de contexto associado a um adaptador de exibição. A função DxgkDdiAddDevice do driver de miniporta de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX.
[in, out] LinkedDevice
Um ponteiro para uma estrutura de LINKED_DEVICE que contém informações sobre a configuração do adaptador de exibição vinculado.
Retornar valor
DxgkDdiLinkDevice retorna STATUS_SUCCESS ou um código de erro apropriado se informações sobre a configuração do adaptador vinculado não puderem ser obtidas.
Comentários
A função DxgkDdiLinkDevice deve ser implementada por drivers de adaptadores de exibição que dão suporte a adaptadores de exibição vinculados.
Se essa função for fornecida, o sistema operacional consultará o driver de miniporto de exibição para a configuração do adaptador vinculado imediatamente após uma chamada ser feita para DxgkDdiAddDevice.
Se o sistema operacional não enumerar todos os adaptadores de exibição esperados na estrutura apontada por LinkedDevice, o sistema será iniciado no modo VGA.
O driver pode enumerar apenas um link à esquerda na cadeia de adaptadores de exibição vinculados.
Plug and Play ou eventos de energia fazem com que o adaptador vinculado líder ligue ou inicie após os adaptadores vinculados restantes ou, por outro lado, tais eventos fazem com que o adaptador vinculado à esquerda desligue ou seja desabilitado antes dos adaptadores vinculados restantes.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | dispmprt.h |
| IRQL | PASSIVE_LEVEL |