Compartilhar via

DXGKCB_SYNCHRONIZE_EXECUTION função de retorno de chamada (dispmprt.h)

  • Artigo

A função DxgkCbSynchronizeExecution sincroniza uma função especificada, implementada pelo driver de miniporto de exibição, com a função DxgkDdiInterruptRoutine do driver de miniporta de exibição.

Sintaxe

DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;

NTSTATUS DxgkcbSynchronizeExecution(
  [in]  HANDLE DeviceHandle,
  [in]  PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
  [in]  PVOID Context,
  [in]  ULONG MessageNumber,
  [out] PBOOLEAN ReturnValue
)
{...}

Parâmetros

[in] DeviceHandle

Um identificador que representa um adaptador de exibição. O driver de miniporto de exibição obteve anteriormente esse identificador no membro DeviceHandle da estrutura DXGKRNL_INTERFACE que foi passada para DxgkDdiStartDevice.

[in] SynchronizeRoutine

Um ponteiro para uma função, implementada pelo driver de miniporta de exibição, que será sincronizada com DxgkDdiInterruptRoutine. A função deve estar em conformidade com o seguinte protótipo:

BOOLEAN SynchronizeRoutine(PVOID Context);

[in] Context

Um ponteiro para um bloco de contexto, criado pelo driver de miniporta de exibição, que será passado para SynchronizeRoutine.

[in] MessageNumber

O número da mensagem de interrupção com a qual SynchronizeRoutine será sincronizada. Se a interrupção for baseada em linha, esse parâmetro deverá ser zero.

[out] ReturnValue

Um ponteiro para uma variável booliana que recebe o valor retornado de SynchronizeRoutine.

Retornar valor

DxgkCbSynchronizeExecution retorna um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS A função foi bem-sucedida.
STATUS_INVALID_PARAMETER Um dos parâmetros é inválido.
STATUS_UNSUCCESSFUL A função não pôde sincronizar a execução, possivelmente porque a interrupção ainda não havia sido conectada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho dispmprt.h (inclua Dispmprt.h)
IRQL <=DISPATCH_LEVEL

Confira também

DxgkDdiInterruptRoutine

KeSynchronizeExecution