Método IPresentationManager::CancelPresentsFrom (presentation.h)
Cancela los regalos emitidos anteriormente y todavía en curso que aún no se han mostrado y cuyos identificadores presentes son al menos los pasados en presentIdToCancelFrom.
Sintaxis
HRESULT CancelPresentsFrom(
UINT64 presentIdToCancelFrom
);
Parámetros
presentIdToCancelFrom
Tipo: UINT64
Identificador del presente desde el que se van a cancelar los regalos que se han emitido pero que aún no se han mostrado.
Valor devuelto
Tipo: HRESULT
Si la función se ejecuta correctamente, devuelve S_OK; de lo contrario, devuelve un HRESULT valor que indica el error.
Comentarios
Si ya se ha mostrado algún presente en el pasado, esta llamada no producirá un error: esos regalos simplemente no se cancelarán. La barrera de retirada actual no se señalará para ningún regalo cancelado, porque cuando se cancelan los regalos, no afectan al presente mostrado actualmente o hacen que comience el proceso de retirada. Por este motivo, se recomienda que, después de realizar un presente, una aplicación consulta los eventos disponibles del búfer para buscar un búfer disponible para emitir en el primer presente después de una cancelación. Una vez que el presente está en cola, permite que el presente mostrado anteriormente inicie el proceso de retirada y señale la barrera de retirada actual.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compilación 22000 de Windows |
| Servidor mínimo compatible | Compilación 22000 de Windows |
| Encabezado | presentation.h |
| Library | dcomp.lib |
| Archivo DLL | dcomp.dll |