Registo de Dispositivos

[A funcionalidade associada a esta página, Windows Media Format 11 SDK, é uma funcionalidade herdada. Foi substituído por Source Reader e Sink Writer. do Source Reader e Sink Writer foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize do Leitor de Origem e do Gravador de Separadores em vez de SDK do Windows Media Format 11, sempre que possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O SDK do Windows Media Format fornece acesso ao banco de dados de registro de dispositivo. Esta base de dados está protegida no computador cliente e é utilizada para registar dispositivos que suportam o Windows Media DRM 10 para Dispositivos de Rede.

Quando um dispositivo é adicionado a uma rede à qual o computador cliente está ligado, o dispositivo tenta contactar uma aplicação transmissora do Windows Media DRM 10 for Network Devices. Depois de estabelecer comunicações, o dispositivo envia uma mensagem de solicitação de registro.

Seu aplicativo deve executar as seguintes etapas quando receber uma mensagem de solicitação de registro:

1. Analise a mensagem chamando o IWMDRMMessageParser::P arseRegistrationReqMsg método. Esse método recupera o certificado do dispositivo e o número de série do dispositivo, ambos necessários para identificar o dispositivo.
2. Chame o método de IWMDeviceRegistration::GetRegisteredDeviceByID, passando o certificado e o número de série do dispositivo recuperados na etapa 1. Se o dispositivo for encontrado, ele já está registrado e você pode pular a próxima etapa.
3. Chame o método de IWMDeviceRegistration::RegisterDevice para adicionar o dispositivo ao banco de dados de registro de dispositivo.

Você pode acessar informações sobre qualquer dispositivo no banco de dados de registro recuperando o objeto de dispositivo registrado associado a ele. Há duas maneiras de obter um objeto de dispositivo registrado. Se você tiver o certificado e o número de série do dispositivo, poderá chamar o IWMDeviceRegistration::GetRegisteredDeviceByID método. Se você não tiver o certificado e o número de série do dispositivo, poderá enumerar todos os dispositivos no banco de dados chamando IWMDeviceRegistration::GetFirstRegisteredDevice seguido por chamadas repetidas para IWMDeviceRegistration::GetNextRegisteredDevice até que uma chamada retorne S_FALSE.

Antes que seu aplicativo possa enviar dados para um dispositivo, você deve garantir que o dispositivo seja aprovado, validado e aberto.

A aprovação do dispositivo deve envolver a interação com o utilizador. Quando um dispositivo envia uma mensagem de registro, seu aplicativo pode solicitar que o usuário decida se o dispositivo deve receber os dados desse usuário. Em seguida, atualize o banco de dados de registro do dispositivo chamando o IWMRegisteredDevice::Approve método, passando TRUE ou FALSE conforme apropriado.

A validação também é chamada de deteção de proximidade. Este é um processo pelo qual os objetos DRM internos do SDK do Windows Media Format determinam se o dispositivo está "próximo" o suficiente do computador que executa seu aplicativo para transmitir mídia com segurança. A proximidade é determinada pelo tempo que demora a obter uma resposta a uma mensagem. Este recurso destina-se a impedir que usuários não autorizados acessem sua rede e obtenham sua mídia segura. Para obter mais informações, consulte Executando a deteção de proximidade.

Para abrir um dispositivo, chame IWMRegisteredDevice::Open.

Tópicos relacionados

IWMRegisteredDevice

Usando o Windows Media DRM 10 para o protocolo de dispositivos de rede