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

아티클
03/05/2024

End3 메서드는 작업이 완료되었음을 나타내기 위해 Windows Media 장치 관리자 호출됩니다. 이 메서드는 이벤트의 ID(ID) 및 명령 컨텍스트에 대한 포인터에 대한 추가 입력 매개 변수를 제공하여 IWMDMProgress2::End2 를 확장합니다.

구문

HRESULT End3(
  [in]      GUID          EventId,
  [in]      HRESULT       hrCompletionCode,
  [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 설정됩니다. 또한 데이터는 다음 플래그 중 하나를 지정합니다. WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	콘텐츠가 디바이스로 또는 디바이스에서 전송되고 있습니다.

[in] hrCompletionCode

진행 중인 작업의 완료 코드를 지정하는 HRESULT입니다. hrCompletionCode 매개 변수는 종료된 작업의 반환 코드입니다. 이 매개 변수는 표준 COM 오류 코드, HRESULT로 변환된 Win32 오류 코드 또는 Windows Media 장치 관리자 오류 코드를 포함한 모든 HRESULT일 수 있습니다.

[in, out] pContext

Windows Media 장치 관리자 처리하지 않고 디바이스로 직접 전송되는 명령을 포함하는 OPAQUECOMMAND 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 컨텍스트 구조는 구성 요소가 이벤트와 관련된 데이터를 애플리케이션에 보내는 방법입니다. 이 구조를 보내는 구성 요소는 애플리케이션이 이 데이터 구조를 해석하는 방법을 정의해야 합니다.

반환 값

이 메서드가 호출되기 전에 현재 작업이 완료되거나 취소되므로 Windows Media 장치 관리자 End3 메서드에서 반환된 반환 코드를 무시합니다.

설명

작업을 구현하는 메서드를 소유하는 인터페이스는 메서드에서 정의한 작업이 완료되면 End3 을 호출합니다.

예제

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


HRESULT End3(GUID  EventId, HRESULT  hrCompletionCode, OPAQUECOMMAND*  pContext)
{
    // TODO: Display the message "IWMDMProgress3::End3 called."
    return S_OK;
}