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

Confira também

DXGK_INTERRUPT_TYPE

DxgkCbNotifyInterrupt

DxgkDdiAddDevice