IWMDRMDeviceApp::AcquireDeviceData メソッド
AcquireDeviceData メソッドは、デバイスのセキュリティで保護されたクロックを初期化またはリセットします。
構文
HRESULT AcquireDeviceData(
[in] IWMDMDevice *pDevice,
[in] IWMDMProgress3 *pProgressCallback,
[in] DWORD dwFlags,
[out] DWORD *pdwStatus
);
パラメーター
-
pDevice [in]
-
測定データを報告するデバイスの IWMDMDevice インターフェイスへのポインター。
-
pProgressCallback [in]
-
アプリケーションがイベントの進行状況を追跡したり、イベントを取り消したりできる進行状況コールバック。 進行状況は、IWMDMProgress3 メソッドの EventId パラメーターによって識別されます。
-
dwFlags [in]
-
実行するアクションを指定する、次のフラグのいずれかまたは両方の論理 OR 。 この値は、IWMDRMDeviceApp::QueryDeviceStatus または IWMDRMDeviceApp2::QueryDeviceStatus2 の pdwStatus パラメーターから取得されます。 pdwStatus フラグは直接使用できます。
フラグ 説明 WMDRM_DEVICE_NEEDCLOCK セキュリティで保護されたクロック サーバーからクロックを取得します。 WMDRM_DEVICE_REFRESHCLOCK セキュリティで保護されたクロック サーバーからクロックを更新します。 -
pdwStatus [out]
-
デバイスから返される状態を指定する次のいずれかの DWORD 値。
Status 説明 0 アクションはサポートされていません。 1 デバイスのセキュリティで保護されたクロックをサービスから取得できませんでした。 2 デバイスのセキュリティで保護されたクロックを設定できませんでした。 3 デバイスのセキュリティで保護されたクロックが設定されました。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
1 つ以上の引数が無効です。 |
|
指定されたデバイスは、Windows Media DRM 互換デバイスではありません。 |
|
デバイスからセキュリティで保護されたクロック チャレンジを取得できなかったか、チャレンジからセキュリティで保護されたクロック URL を取得できませんでした。 |
|
セキュリティで保護されたクロック サーバーからセキュリティで保護されたクロック応答を取得できませんでした。 |
|
セキュリティで保護されたクロック チャレンジをデバイスに送信できませんでした。または、デバイスがクロックを設定できませんでした。 |
注釈
これは非同期メソッドです。デバイスは、ライセンスされたコンテンツを再生する前に、この操作の IWMDMProgress::End コールバックを待機する必要があります。
アプリケーションは、IWMDRMDeviceApp::QueryDeviceStatus または IWMDRMDeviceApp2::QueryDeviceStatus2 を呼び出すことによって、デバイスのクロック リセットまたは更新が必要かどうかを学習できます。
セキュリティで保護されたクロックを取得またはリセットするには、アプリケーションにインターネット接続が必要です。
要件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|