Метод IWMDMProgress::P rogress (mswmdm.h)

Статья
03/05/2024

Метод Progress указывает, что операция все еще выполняется.

Синтаксис

HRESULT Progress(
  [in] DWORD dwTranspiredTicks
);

Параметры

[in] dwTranspiredTicks

Значение DWORD , указывающее количество тактов, которые уже возникли.

Возвращаемое значение

Приложение должно вернуть одно из следующих значений HRESULT .

Код возврата	Описание
S_OK	Операция должна быть продолжена.
WMDM_E_USER_CANCELLED	Диспетчер устройств Windows Media должны отменить текущую операцию, не дожидаясь ее завершения. Если приложение использует блочный режим, диспетчер устройств Windows Media вернет эту ошибку приложению.

Этот метод вызывается всеми другими методами Windows Media диспетчер устройств. Цель заключается в том, что Progress будет вызываться один раз для каждого предполагаемого тактова. Однако параметр dwTranspiredTicks должен проверяться при каждом вызове, так как выполняемая операция не может гарантировать один вызов для каждого предполагаемого такта.

Приложение возвращает S_OK вызывающему методу, чтобы указать, что операция должна продолжаться. Приложение возвращает WMDM_E_USER_CANCELLED, чтобы указать, что операция должна быть отменена. Если приложение использует блочный режим и возвращает WMDM_E_USER_CANCELLED, диспетчер устройств Windows Media вернет приложению ту же ошибку.

Примеры

Следующий код C++ представляет собой простую реализацию метода Progress .


HRESULT Progress(DWORD  dwTranspiredTicks)
{
    // TODO: Display the message: "IWMDMProgress::Progress called" 
    // followed by the dwTranspiredTicks value.
    return S_OK;
}