IWMDMProgress::Begin 메서드(mswmdm.h)

아티클
03/13/2024

Begin 메서드는 작업이 시작 중임을 나타냅니다. 가능한 경우 작업의 예상 기간이 제공됩니다.

구문

HRESULT Begin(
  [in] DWORD dwEstimatedTicks
);

매개 변수

[in] dwEstimatedTicks

작업을 완료하는 데 필요한 예상 틱 수를 지정하는 DWORD입니다.

반환 값

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

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

설명

이 작업은 작업이 시작되었음을 나타내기 위해 다양한 메서드에 의해 호출됩니다. dwEstimatedTicks에 전달된 틱 수는 작업을 완료하는 데 필요한 틱 수를 예측합니다. 작업 과정에서 Progress 메서드가 호출되어 발생한 틱 수를 나타냅니다. 애플리케이션은 예상을 사용하여 진행률을 표시하는 표시 메커니즘을 구성할 수 있습니다.

IWMDMProgress3::Begin3 메서드는 어떤 작업이 발생하는지에 대한 자세한 정보를 제공합니다.

예제

다음 C++ 코드는 Begin 메서드의 구현입니다.


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