裝置註冊

[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器接收寫入器已取代它。 來源讀取器接收寫入器 已針對 Windows 10 和 Windows 11 優化。 Microsoft強烈建議新程式代碼盡可能使用 來源讀取器接收寫入器,而不是 Windows Media Format 11 SDK。 Microsoft建議使用舊版 API 的現有程式代碼,盡可能改寫成使用新的 API。]

Windows 媒體格式 SDK 提供裝置註冊資料庫的存取權。 此資料庫在用戶端電腦上受到保護,並用來註冊支持網路裝置之 Windows Media DRM 10 的裝置。

當裝置新增至用戶端電腦連線的網路時,裝置會嘗試連絡 Windows Media DRM 10 進行網路裝置傳輸應用程式。 建立通訊之後,裝置會傳送註冊要求訊息。

您的應用程式在收到註冊要求訊息時,應該執行下列步驟:

  1. 呼叫 IWMDRMMessageParser::P arseRegistrationReqMsg 方法來剖析訊息。 此方法會擷取裝置憑證和裝置序號,這兩者都需要用來識別裝置。
  2. 呼叫 IWMDeviceRegistration::GetRegisteredDeviceByID 方法,傳入步驟 1 中擷取的憑證和裝置序號。 如果找到裝置,表示裝置已註冊,您可以略過下一個步驟。
  3. 呼叫 IWMDeviceRegistration::RegisterDevice 方法,將裝置新增至裝置註冊資料庫。

您可以擷取與其相關聯的已註冊裝置物件,來存取註冊資料庫中任何裝置的相關信息。 有兩種方式可以取得已註冊的裝置物件。 如果您有裝置的憑證和序號,您可以呼叫 IWMDeviceRegistration::GetRegisteredDeviceByID 方法。 如果您沒有裝置的憑證和序號,您可以呼叫 IWMDeviceRegistration::GetFirstRegisteredDevice,然後重複 呼叫 IWMDeviceRegistration::GetNextRegisteredDevice,以列舉資料庫中的所有裝置,直到呼叫傳回S_FALSE為止。

在應用程式將資料傳送至裝置之前,您必須先確定裝置已核准、驗證及開啟。

裝置核准應該涉及與用戶的互動。 當裝置傳送註冊訊息時,您的應用程式可以提示用戶決定是否應該接收該用戶數據的裝置。 然後呼叫 IWMRegisteredDevice::Approve 方法來更新裝置註冊資料庫,並視需要傳遞 TRUEFALSE

驗證也稱為鄰近偵測。 這是 Windows 媒體格式 SDK 的內部DRM物件判斷裝置是否「接近」到執行應用程式的電腦,以安全地傳輸媒體的程式。 近度取決於取得訊息回應所需的時間。 這項功能旨在防止未經授權的使用者存取您的網路,並取得您的安全媒體。 如需詳細資訊,請參閱 執行鄰近偵測

若要開啟裝置,請呼叫 IWMRegisteredDevice::Open

注意

此 SDK 的 x64 型版本不支援DRM。

 

IWMRegisteredDevice

使用 Windows Media DRM 10 進行網路裝置通訊協定