Apparaatregistratie

[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.]

De Windows Media Format SDK biedt toegang tot de apparaatregistratiedatabase. Deze database is beveiligd op de clientcomputer en wordt gebruikt voor het registreren van apparaten die Ondersteuning bieden voor Windows Media DRM 10 voor netwerkapparaten.

Wanneer een apparaat wordt toegevoegd aan een netwerk waarmee de clientcomputer is verbonden, probeert het apparaat contact op te maken met een Windows Media DRM 10 voor netwerkapparatenzendertoepassing. Na het tot stand brengen van de communicatie verzendt het apparaat een registratieaanvraagbericht.

Uw toepassing moet de volgende stappen uitvoeren wanneer er een registratieaanvraagbericht wordt ontvangen:

  1. Parseer het bericht door de methode IWMDRMMessageParser::P arseRegistrationReqMsg aan te roepen. Met deze methode worden het apparaatcertificaat en het serienummer van het apparaat opgehaald, die beide nodig zijn om het apparaat te identificeren.
  2. Roep de IWMDeviceRegistration::GetRegisteredDeviceByID methode aan, waarbij het certificaat en het serienummer van het apparaat worden doorgegeven dat is opgehaald in stap 1. Als het apparaat is gevonden, is het al geregistreerd en kunt u de volgende stap overslaan.
  3. Roep de IWMDeviceRegistration::RegisterDevice methode aan om het apparaat toe te voegen aan de apparaatregistratiedatabase.

U kunt toegang krijgen tot informatie over elk apparaat in de registratiedatabase door het geregistreerde apparaatobject op te halen dat eraan is gekoppeld. Er zijn twee manieren om een geregistreerd apparaatobject op te halen. Als u het certificaat en het serienummer van het apparaat hebt, kunt u de methode IWMDeviceRegistration::GetRegisteredDeviceByID aanroepen. Als u het certificaat en serienummer van het apparaat niet hebt, kunt u alle apparaten in de database inventariseren door IWMDeviceRegistration::GetFirstRegisteredDevice gevolgd door herhaalde aanroepen naar IWMDeviceRegistration::GetNextRegisteredDevice totdat een aanroep S_FALSE retourneert.

Voordat uw toepassing gegevens naar een apparaat kan verzenden, moet u ervoor zorgen dat het apparaat is goedgekeurd, gevalideerd en geopend.

Apparaatgoedkeuring moet betrekking hebben op interactie met de gebruiker. Wanneer een apparaat een registratiebericht verzendt, kan uw toepassing de gebruiker vragen om te bepalen of het apparaat een apparaat is dat de gegevens van die gebruiker moet ontvangen. Werk vervolgens de database voor apparaatregistratie bij door de methode IWMRegisteredDevice::Approve methode, waarbij TRUE of FALSE wordt doorgegeven.

Validatie wordt ook wel nabijheidsdetectie genoemd. Dit is een proces waarbij de interne DRM-objecten van de Windows Media Format SDK bepalen of het apparaat 'in de buurt' is van de computer waarop uw toepassing wordt uitgevoerd om veilig media te verzenden. De nabijheid wordt bepaald door de tijd die nodig is om een antwoord op een bericht te krijgen. Deze functie is bedoeld om te voorkomen dat onbevoegde gebruikers toegang hebben tot uw netwerk en uw beveiligde media verkrijgen. Zie Proximity Detectionuitvoeren voor meer informatie.

Als u een apparaat wilt openen, roept u IWMRegisteredDevice::Open.

Notitie

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

 

IWMRegisteredDevice-

Windows Media DRM 10 voor Network Devices Protocol gebruiken