Nabijheidsdetectie uitvoeren

[De functie die is gekoppeld aan deze pagina, Windows Media Format 11 SDK, is een verouderde functie. Het is vervangen door Source Reader en Sink Writer. Bronlezer en Sink Writer zijn geoptimaliseerd voor Windows 10 en Windows 11. Microsoft raadt ten zeerste aan om nieuwe code te gebruiken bronlezer en Sink Writer- in plaats van Windows Media Format 11 SDK, indien mogelijk. Microsoft stelt voor dat bestaande code die gebruikmaakt van de verouderde API's, indien mogelijk opnieuw worden geschreven om de nieuwe API's te gebruiken.]

Voordat u versleutelde gegevens kunt streamen naar een geregistreerd apparaat in het protocol Windows Media DRM 10 voor netwerkapparaten, moet u een proces uitvoeren met de naam nabijheidsdetectie (ook wel validatie genoemd). Dit proces omvat het verzenden van berichten naar het apparaat en het ontvangen van antwoorden. De tijd die nodig is om een antwoord te ontvangen, wordt gebruikt om te bepalen of het apparaat 'bijna' genoeg is voor de computer in het netwerk om beveiligde gegevens te ontvangen. Als u bevestigt dat het apparaat zich fysiek dicht bij de clientcomputer in het netwerk bevindt, kunt u adresvervalsing en andere onbevoegde toegang voorkomen.

Wanneer de nabijheidsdetectie is voltooid, wordt gezegd dat het apparaat geldig is. U kunt controleren of een apparaat geldig is door de methode IWMRegisteredDevice::IsValid aan te roepen. Apparaten moeten elke 48 uur worden gevalideerd. Een apparaat dat meer dan 48 uur is gevalideerd voordat het programma wordt uitgevoerd, moet opnieuw worden gevalideerd door het nabijheidsdetectieproces opnieuw uit te voeren.

Als u nabijheidsdetectie wilt uitvoeren, moet u communicatie met het apparaat tot stand brengen en vervolgens de methode IWMProximityDetection::StartDetection aanroepen. Het detectieproces wordt asynchroon voltooid door de interne DRM-onderdelen van de Windows Media Format SDK. Uw toepassing moet een implementatie bevatten van de IWMStatusCallback-interface interface voor het verwerken van nabijheidsdetectieberichten.

Er zijn twee berichten die worden verzonden door het nabijheidsdetectieproces: een resultaatbericht en een voltooiingsbericht.

Het resultaatbericht, WMT_PROXIMITY_RESULT, wordt verzonden wanneer het detectieproces is voltooid. De hr parameter van de OnStatus callbackmethode geeft aan of het apparaat nabij genoeg bevonden is voor de clientcomputer. Als de parameter hr van het resultaatbericht aangeeft dat het is gelukt, bevat de parameter pValue een DWORD- waarmee de gemeten latentie voor het apparaat in milliseconden wordt opgegeven.

Het voltooiingsbericht, WMT_PROXIMITY_COMPLETED, wordt verzonden wanneer de detectie is voltooid. U moet de interface IWMProximityDetection pas vrijgeven nadat u dit bericht hebt ontvangen.

Wanneer de nabijheidsdetectie voor een apparaat slaagt, wordt de registratiedatabase van het apparaat automatisch bijgewerkt. Volgende aanroepen naar IWMRegisteredDevice::IsValid retourneren TRUE gedurende 48 uur, totdat het apparaat opnieuw moet worden gevalideerd.

Opmerking DRM wordt niet ondersteund door de x64-versie van deze SDK.

Verwante onderwerpen

Windows Media DRM 10 voor Network Devices Protocol gebruiken