Durchführen der Näherungserkennung
[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Es wurde von Source Reader und Sink Writer abgelöst. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit quellleser und Senkenschreiber anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Bevor Sie verschlüsselte Daten an ein registriertes Gerät im Windows Media DRM 10 for Network Devices-Protokoll streamen können, müssen Sie einen Prozess ausführen, der als Näherungserkennung (auch Als Validierung bezeichnet) bezeichnet wird. Dieser Prozess umfasst das Senden von Nachrichten an das Gerät und das Empfangen von Antworten. Die Zeit, die zum Empfangen einer Antwort benötigt wird, wird verwendet, um zu bestimmen, ob das Gerät dem Computer im Netzwerk "nahe" genug ist, um sichere Daten zu empfangen. Die Bestätigung, dass sich das Gerät physisch in der Nähe des Clientcomputers im Netzwerk befindet, hilft, Spoofing und anderen nicht autorisierten Zugriff zu verhindern.
Wenn die Näherungserkennung erfolgreich abgeschlossen wurde, gilt das Gerät als gültig. Sie können überprüfen, ob ein Gerät gültig ist, indem Sie die IWMRegisteredDevice::IsValid-Methode aufrufen. Geräte müssen alle 48 Stunden überprüft werden. Ein Gerät, das mehr als 48 Stunden vor der Programmausführung überprüft wurde, muss erneut überprüft werden, indem der Näherungserkennungsprozess erneut ausgeführt wird.
Um die Näherungserkennung durchzuführen, müssen Sie die Kommunikation mit dem Gerät herstellen und dann die IWMProximityDetection::StartDetection-Methode aufrufen. Der Erkennungsprozess wird asynchron durch die internen DRM-Komponenten des Windows Media Format SDK abgeschlossen. Ihre Anwendung muss eine Implementierung der IWMStatusCallback-Schnittstelle enthalten, um Näherungserkennungsmeldungen verarbeiten zu können.
Es gibt zwei Nachrichten, die vom Näherungserkennungsprozess gesendet werden: eine Ergebnismeldung und eine Abschlussmeldung.
Die Ergebnismeldung WMT_PROXIMITY_RESULT wird gesendet, wenn der Erkennungsprozess abgeschlossen ist. Der hr-Parameter der OnStatus-Rückrufmethode gibt an, ob das Gerät in der Nähe des Clientcomputers gefunden wurde. Wenn der hr-Parameter der Ergebnismeldung den Erfolg angibt, enthält der pValue-Parameter ein DWORD , das die gemessene Latenz für das Gerät in Millisekunden angibt.
Die Abschlussmeldung WMT_PROXIMITY_COMPLETED wird gesendet, wenn die Erkennung abgeschlossen ist. Sie sollten die IWMProximityDetection-Schnittstelle erst freigeben, nachdem Sie diese Nachricht erhalten haben.
Wenn die Näherungserkennung für ein Gerät erfolgreich ist, wird die Geräteregistrierungsdatenbank automatisch aktualisiert. Nachfolgende Aufrufe von IWMRegisteredDevice::IsValid geben TRUE zurück, bis 48 Stunden vergangen sind und das Gerät erneut überprüft werden muss.
Hinweis DRM wird von der x64-basierten Version dieses SDK nicht unterstützt.
Zugehörige Themen