Метод IWMDMProgress3::End3 (mswmdm.h)
Метод End3 вызывается windows Media диспетчер устройств, чтобы указать, что операция завершена. Этот метод расширяет IWMDMProgress2::End2 , предоставляя дополнительные входные параметры для идентификации (идентификатора) события и указателя на контекст команд.
Синтаксис
HRESULT End3(
[in] GUID EventId,
[in] HRESULT hrCompletionCode,
[in, out] OPAQUECOMMAND *pContext
);
Параметры
[in] EventId
GUID, указывающий событие, которое завершается. Возможные значения перечислены в следующей таблице.
| Событие | Описание |
|---|---|
| SCP_EVENTID_ACQSECURECLOCK | Windows Media диспетчер устройств получает защищенные часы с сервера. |
| SCP_EVENTID_NEEDTOINDIV | Устройство выполняется индивидуализируется. В настоящее время этот параметр не используется. |
| SCP_EVENTID_DRMINFO |
Этот идентификатор события используется для уведомления приложения с заголовком 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 — это код возврата завершившейся операции. Этот параметр может быть любым HRESULT, включая стандартные коды ошибок COM, коды ошибок Win32, преобразованные в HRESULT, или Windows Media диспетчер устройств коды ошибок.
[in, out] pContext
Указатель на структуру OPAQUECOMMAND, содержащую команду, отправленную непосредственно на устройство без обработки windows Media диспетчер устройств. Этот параметр является необязательным и может иметь значение 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;
}
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | mswmdm.h |
| Библиотека | Mssachlp.lib |