IWMDMProgress::P rogress 메서드(mswmdm.h)

아티클
02/29/2024

Progress 메서드는 작업이 아직 진행 중임을 나타냅니다.

구문

HRESULT Progress(
  [in] DWORD dwTranspiredTicks
);

매개 변수

[in] dwTranspiredTicks

지금까지 일어난 틱 수를 지정하는 DWORD입니다.

반환 값

애플리케이션은 다음 HRESULT 값 중 하나를 반환해야 합니다.

반환 코드	Description
S_OK	작업은 계속되어야 합니다.
WMDM_E_USER_CANCELLED	Windows Media 장치 관리자 완료되기를 기다리지 않고 현재 작업을 취소해야 합니다. 애플리케이션이 블록 모드를 사용하는 경우 Windows Media 장치 관리자 이 오류를 애플리케이션에 반환합니다.

설명

이 메서드는 다른 모든 Windows Media 장치 관리자 메서드에서 호출됩니다. 예상 틱당 한 번씩 진행률이 호출됩니다. 그러나 수행 중인 작업이 예상된 각 틱에 대해 한 번 호출을 보장하지 않을 수 있으므로 각 호출에서 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;
}