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 miniporto de exibição anteriormente forneceu 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.
Valor de retorno
DxgkDdiLinkDevice retorna STATUS_SUCCESS ou um código de erro apropriado se as informações sobre a configuração do adaptador vinculado não puderem ser obtidas.
Observações
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.
Os eventos plug and Play ou power fazem com que o adaptador vinculado à esquerda acione ou inicie após os adaptadores vinculados restantes ou, por outro lado, esses eventos fazem com que o adaptador vinculado principal desligue ou seja desabilitado antes dos adaptadores vinculados restantes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h |
| IRQL | PASSIVE_LEVEL |