DRMRIGHTS 結構 (drmk.h)

  • 發行項

DRMRIGHTS 結構會指定指派給 KS 音訊釘選或埠類別驅動程式數據流物件的DRM內容許可權。

語法

typedef struct tagDRMRIGHTS {
  BOOL  CopyProtect;
  ULONG Reserved;
  BOOL  DigitalOutputDisable;
} DRMRIGHTS, *PDRMRIGHTS;

成員

CopyProtect

指定下列其中一個複製保護值：

TRUE

啟用複製保護。 音訊應用程式不得執行下列動作：

  • 將內容以任何形式儲存在任何非大量記憶體中。
  • 依參考或傳值將內容傳遞至未由DRM系統驗證的主機系統內的任何其他元件。

false

停用複製保護。 內容可以複製，而不受限制。

如需 CopyProtect 的詳細資訊，請參閱一節。

Reserved

保留供未來使用。 初始化為零。

DigitalOutputDisable

指定下列其中一個數字輸出保護值：

TRUE

停用數字輸出。 軟體元件不得透過任何類型的數位介面，將內容移出主機系統。 請注意，數位輸出保護不會影響USB裝置，因為主機系統包含USB裝置。

false

啟用數字輸出。 內容可以從主機系統傳輸至外部元件，而不受限制。

如需 DigitalOutputDisable 的詳細資訊，請參閱一節。

備註

Windows 認證計劃會在音訊驅動程式處理 CopyProtect 和 DigitalOutputDisable 值的方式上放置特定需求。 當 CopyProtect 和 DigitalOutputDisable 值套用至音訊數據流，以及存取音訊數據流的輸出時，這些需求適用。 Windows 7 的新需求包括針對 S/PDIF 端點進行串行複製管理系統 (SCMS) 程式設計的正確方式，以及 HDMI 端點的高頻寬數位內容保護 (HDCP) 。

下表摘要說明驅動程序必須針對 CopyProtect 和 DigitalOutputDisable 的不同值建立的內容保護狀態。

DRMRIGHTS 布爾成員 產生的內容保護
DigitalOutputDisable CopyProtect HDMI 和顯示埠 S/PDIF
False False 未啟用 HDCP 未啟用 SCMS
False 對 使用 HDCP 啟用 使用 SCMS 啟用
對 不小心 使用 HDCP 啟用 已停用
 
注意 如果驅動程式無法正確套用 HDCP 或 SCMS，驅動程式必須停用端點的輸出。
 
當音訊驅動程式將 SCMS 複製保護套用至 S/PDIF 端點時，音訊驅動程式會使用 L、Cp 和類別代碼位的組合來選取 SCMS 狀態「永遠複製」。 如需數位內容複製保護的詳細資訊，請參閱 IEC 網站上的 IEC 60958 。

如果驅動程式支援DRMRIGHTS並實作專屬複製保護機制，則驅動程式必須將專屬實作的結果與 CopyProtect 和 DigitalOutputDisable 的值匯總，以判斷最終的複製保護狀態。 最終複製保護狀態必須是所有未完成複製保護要求的最嚴格限制。

DEFINE_DRMRIGHTS_DEFAULT宏會定義常數DRMRIGHTS結構，指定預設DRM內容許可權。

VOID DEFINE_DRMRIGHTS_DEFAULT(
   DRMRIGHTS DrmRights
);

參數

DrmRights

DRMRIGHTS

指定常數DRMRIGHTS結構的名稱。 宏會將 DrmRights 的成員設定為下列預設值：

傳回值

無效

此宏不會傳回值。

規格需求

需求 值
標頭 drmk.h (包括Drmk.h)

另請參閱

DrmCreateContentMixed

DrmDestroyContent

DrmForwardContentToFileObject

DrmForwardContentToInterface

DrmGetContentRights

IEC 60958