Método IPresentationManager::CancelPresentsFrom (presentation.h)
Cancela todos os presentes emitidos anteriormente e ainda em pré-lançamento que ainda não foram exibidos e cujas IDs presentes são pelo menos as passadas em presentIdToCancelFrom.
Sintaxe
HRESULT CancelPresentsFrom(
UINT64 presentIdToCancelFrom
);
Parâmetros
presentIdToCancelFrom
Tipo: UINT64
O identificador do presente do qual cancelar presentes que foram emitidos, mas que ainda não foram exibidos.
Retornar valor
Tipo: HRESULT
Se a função for bem-sucedida, ela retornará S_OK; caso contrário, retornará um HRESULT valor que indica o erro.
Comentários
Se algum presente no passado já tiver sido exibido, essa chamada não falhará – esses presentes simplesmente não serão cancelados. A cerca de desativação atual não será sinalizada para nenhum presente cancelado, pois quando os presentes são cancelados, eles não afetam o presente atualmente exibido ou fazem com que ele inicie o processo de desativação. Por esse motivo, é sugerido que, depois de executar um presente, um aplicativo consulta eventos disponíveis do buffer para encontrar um buffer disponível para emitir no primeiro presente após um cancelamento. Depois que esse presente estiver na fila, ele permitirá que o presente exibido anteriormente inicie o processo de desativação e sinalize a cerca de desativação atual.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Build 22000 |
| Servidor mínimo com suporte | Windows Build 22000 |
| Cabeçalho | presentation.h |
| Biblioteca | dcomp.lib |
| DLL | dcomp.dll |