DXGKCB_SYNCHRONIZE_EXECUTION função de retorno de chamada (dispmprt.h)
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 |