DXGKDDI_CONTROLINTERRUPT função de retorno de chamada (d3dkmddi.h)
A função DxgkDdiControlInterrupt habilita ou desabilita o tipo de interrupção fornecido no hardware gráfico.
Sintaxe
DXGKDDI_CONTROLINTERRUPT DxgkddiControlinterrupt;
NTSTATUS DxgkddiControlinterrupt(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_DXGK_INTERRUPT_TYPE InterruptType,
[in] IN_BOOLEAN EnableInterrupt
)
{...}
Parâmetros
[in] hAdapter
Um identificador para o objeto do adaptador para a GPU (unidade de processamento de elementos gráficos). O driver retornou esse identificador no parâmetro MiniportDeviceContext de uma chamada para sua função de DxgkDdiAddDevice.
[in] InterruptType
Um valor de tipo DXGK_INTERRUPT_TYPEque fornece o tipo de interrupção.
[in] EnableInterrupt
Um valor booliano que indica se DxgkDdiControlInterrupt habilita ou desabilita o tipo de interrupção especificado. TRUE indica que ele habilita e FALSE indica que ele desabilita.
Valor de retorno
DxgkDdiControlInterrupt retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | O tipo de interrupção foi habilitado ou desabilitado com êxito no hardware gráfico. |
| STATUS_NOT_IMPLEMENTED | DxgkDdiControlInterrupt não dá suporte à habilitação ou desabilitação do tipo de interrupção especificado. |
Observações
A função DxgkDdiControlInterrupt do driver de miniporto de exibição pode habilitar ou desabilitar o tipo de interrupção especificado. No entanto, DxgkDdiControlInterrupt não será necessário para desabilitar o tipo de interrupção se o driver exigir o tipo de interrupção para uma finalidade interna. Uma chamada para DxgkDdiControlInterrupt para habilitar o tipo de interrupção especificado indica que o sistema operacional requer que o driver chame a função DxgkCbNotifyInterrupt para relatar quando o tipo de interrupção é disparado no hardware gráfico.
Atualmente, o subsistema de kernel de elementos gráficos do Microsoft DirectX especifica apenas o tipo de interrupção DXGK_INTERRUPT_CRTC_VSYNC no parâmetro InterruptType. Uma chamada para DxgkDdiControlInterrupt para habilitar o tipo de interrupção DXGK_INTERRUPT_CRTC_VSYNC indica que o driver controlará a interrupção de rastreamento vertical. Durante cada período de retração vertical e imediatamente após o endereço da superfície primária especificado no registro da DAC ser travado e verificado, a interrupção deve ser disparada e relatada.
O driver deve retornar STATUS_NOT_IMPLEMENTED se um tipo de interrupção diferente de DXGK_INTERRUPT_CRTC_VSYNC for fornecido.
DxgkDdiControlInterrupt deve ficar paginável.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |