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 gráfico). O driver retornou esse identificador no parâmetro MiniportDeviceContext de uma chamada para sua função DxgkDdiAddDevice .
[in] InterruptType
Um valor de tipo DXGK_INTERRUPT_TYPE que 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.
Retornar valor
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. |
Comentários
A função DxgkDdiControlInterrupt do driver de miniporta 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 vertical do rastreamento. Durante cada período de novo rastreamento 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 deverá retornar STATUS_NOT_IMPLEMENTED se um tipo de interrupção diferente de DXGK_INTERRUPT_CRTC_VSYNC for fornecido.
DxgkDdiControlInterrupt deve ser tornado paginável.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista |
Plataforma de Destino | Área de Trabalho |
Cabeçalho | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |