Melakukan Deteksi Kedekatan

  • Artikel

[Fitur yang terkait dengan halaman ini, Windows Media Format 11 SDK, adalah fitur warisan. Ini telah digantikan oleh Pembaca Sumber dan Penulis Sink. Pembaca Sumber dan Penulis Sink telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan Pembaca Sumber dan Penulis Sink alih-alih Windows Media Format 11 SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Sebelum Anda dapat mengalirkan data terenkripsi ke perangkat terdaftar di protokol Windows Media DRM 10 untuk Perangkat Jaringan, Anda harus melakukan proses yang disebut deteksi kedekatan (juga disebut validasi). Proses ini melibatkan pengiriman pesan ke perangkat dan menerima respons. Waktu yang diperlukan untuk menerima respons digunakan untuk menentukan apakah perangkat "dekat" cukup dengan komputer di jaringan untuk menerima data yang aman. Mengonfirmasi bahwa perangkat secara fisik dekat dengan komputer klien di jaringan membantu mencegah spoofing dan akses tidak sah lainnya.

Ketika deteksi kedekatan berhasil diselesaikan, perangkat dikatakan valid. Anda dapat memeriksa apakah perangkat valid dengan memanggil metode IWMRegisteredDevice::IsValid . Perangkat harus divalidasi setiap 48 jam. Perangkat yang divalidasi lebih dari 48 jam sebelum program Anda berjalan harus divalidasi ulang dengan melakukan proses deteksi kedekatan lagi.

Untuk melakukan deteksi kedekatan, Anda harus membangun komunikasi dengan perangkat lalu memanggil metode IWMProximityDetection::StartDetection . Proses deteksi diselesaikan secara asinkron oleh komponen DRM internal Dari Windows Media Format SDK. Aplikasi Anda harus menyertakan implementasi antarmuka IWMStatusCallback untuk memproses pesan deteksi kedekatan.

Ada dua pesan yang dikirim oleh proses deteksi kedekatan: pesan hasil dan pesan penyelesaian.

Pesan hasil, WMT_PROXIMITY_RESULT, dikirim ketika proses deteksi selesai. Parameter hr dari metode panggilan balik OnStatus menunjukkan apakah perangkat ditemukan cukup dekat dengan komputer klien. Jika parameter hr pesan hasil menunjukkan keberhasilan, parameter pValue berisi DWORD yang menentukan latensi yang diukur ke perangkat dalam milidetik.

Pesan penyelesaian, WMT_PROXIMITY_COMPLETED, dikirim ketika deteksi selesai. Anda harus merilis antarmuka IWMProximityDetection hanya setelah menerima pesan ini.

Ketika deteksi kedekatan untuk perangkat berhasil, database pendaftaran perangkat diperbarui secara otomatis. Panggilan berikutnya ke IWMRegisteredDevice::IsValid akan mengembalikan TRUE hingga 48 jam berlalu dan perangkat perlu divalidasi ulang.

Catatan DRM tidak didukung oleh versi berbasis x64 dari SDK ini.

Menggunakan Windows Media DRM 10 untuk Protokol Perangkat Jaringan