Método IWMDMProgress3::End3 (mswmdm.h)

Artigo
03/05/2024

O método End3 é chamado pelo Windows Media Gerenciador de Dispositivos para indicar que uma operação foi concluída. Esse método estende IWMDMProgress2::End2 fornecendo parâmetros de entrada adicionais para a identificação (ID) do evento e para um ponteiro para o contexto dos comandos.

Sintaxe

HRESULT End3(
  [in]      GUID          EventId,
  [in]      HRESULT       hrCompletionCode,
  [in, out] OPAQUECOMMAND *pContext
);

Parâmetros

[in] EventId

Um GUID que especifica o evento que está terminando. Os valores possíveis são mostrados na tabela a seguir.

Evento	Descrição
SCP_EVENTID_ACQSECURECLOCK	O Windows Media Gerenciador de Dispositivos está adquirindo um relógio seguro do servidor.
SCP_EVENTID_NEEDTOINDIV	O dispositivo está sendo individualizado. Isso não é usado no momento.
SCP_EVENTID_DRMINFO	Essa ID de evento é usada para notificar o aplicativo com o cabeçalho DRM de versão encontrado no conteúdo de cada arquivo. A estrutura OPAQUECOMMAND retornada tem o membro guidCommand definido como SCP_PARAMID_DRMVERSION. Além disso, os dados especificam um dos seguintes sinalizadores: WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	O conteúdo está sendo transferido de ou para o dispositivo.

[in] hrCompletionCode

HRESULT especificando o código de conclusão da operação que estava em andamento. O parâmetro hrCompletionCode é o código de retorno da operação que terminou. Esse parâmetro pode ser qualquer HRESULT, incluindo códigos de erro COM padrão, códigos de erro Win32 convertidos em HRESULT ou códigos de erro de Gerenciador de Dispositivos do Windows Media.

[in, out] pContext

Ponteiro para uma estrutura OPAQUECOMMAND que contém um comando enviado diretamente para o dispositivo sem ser manipulado pelo Windows Media Gerenciador de Dispositivos. Esse parâmetro é opcional e pode ser NULL. A estrutura de contexto é uma maneira de o componente enviar quaisquer dados relevantes com o evento para o aplicativo. O componente que envia essa estrutura deve definir como o aplicativo pode interpretar essa estrutura de dados.

Retornar valor

O Windows Media Gerenciador de Dispositivos ignora qualquer código de retorno retornado pelo método End3 porque a operação atual foi concluída ou cancelada antes que esse método seja chamado.

Comentários

A interface que possui o método que está implementando uma operação chama End3 quando a operação definida pelo método é concluída.

Exemplos

O código C++ a seguir mostra um exemplo de implementação do End3.


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