IWMDMProgress3::Begin3 메서드(mswmdm.h)

아티클
03/05/2024

Begin3 메서드는 Windows Media 장치 관리자 작업을 시작하려고 함을 나타내기 위해 호출됩니다. 가능한 경우 작업의 예상 기간이 제공됩니다. 이 메서드는 이벤트의 ID(ID) 및 명령의 선택적 컨텍스트에 대한 포인터에 대한 추가 입력 매개 변수를 제공하여 IWMDMProgress::Begin 을 확장합니다. 작업은 이벤트 ID로 식별됩니다. 메서드를 사용하면 호출자가 불투명 데이터 구조를 애플리케이션에 전달할 수 있습니다.

구문

HRESULT Begin3(
  [in]      GUID          EventId,
  [in]      DWORD         dwEstimatedTicks,
  [in, out] OPAQUECOMMAND *pContext
);

매개 변수

[in] EventId

시작할 작업을 식별하는 GUID 입니다. 가능한 값은 다음 표에 나와 있습니다.

이벤트	Description
SCP_EVENTID_ACQSECURECLOCK	Windows Media 장치 관리자 서버에서 보안 시계를 획득하고 있습니다.
SCP_EVENTID_NEEDTOINDIV	디바이스가 개별화되고 있습니다. 현재 사용되지 않습니다.
SCP_EVENTID_DRMINFO	이 이벤트 ID는 각 파일의 콘텐츠에 있는 버전 DRM 헤더를 사용하여 애플리케이션에 알리는 데 사용됩니다. 반환된 OPAQUECOMMAND 구조체에는 guidCommand 멤버가 SCP_PARAMID_DRMVERSION 설정됩니다. 또한 OPAQUECOMMAND는 다음 플래그 중 하나를 지정합니다. WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	콘텐츠가 디바이스로 또는 디바이스에서 전송되고 있습니다.

[in] dwEstimatedTicks

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

[in, out] pContext

Windows Media 장치 관리자 처리하지 않고 디바이스로 전송된 명령을 포함하는 OPAQUECOMMAND 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

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

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

설명

애플리케이션은 작업을 계속해야 함을 나타내고 작업을 취소해야 함을 나타내기 위해 WMDM_E_USER_CANCELLED S_OK 반환합니다. 애플리케이션이 블록 모드를 사용하고 WMDM_E_USER_CANCELLED 반환하는 경우 Windows Media 장치 관리자 동일한 오류를 애플리케이션에 반환합니다.

예제

다음 C++ 코드는 Begin3의 예제 구현을 보여줍니다.


HRESULT Begin3(GUID  EventId, DWORD  dwEstimatedTicks, OPAQUECOMMAND*  pContext)
{
    WCHAR strGuid[64];
    StringFromGUID2(reinterpret_cast<GUID&>(EventId),(LPOLESTR)strGuid, 64);
    // TODO: Display the message "IWMDMProgress3::Begin3 called." 
    // followed by the strGuid value.
    return S_OK;
}