IDrmAudioStream：：SetContentId 方法（drmk.h）

SetContentId 方法會在 KS 音訊數據流上設定DRM內容識別碼及其指派的DRM內容許可權。

語法

NTSTATUS SetContentId(
  [in] ULONG       ContentId,
  [in] PCDRMRIGHTS DrmRights
);

[in] ContentId

指定DRM內容識別碼。此參數是DRM系統在運行時間產生的標識碼，用來識別此數據流中受DRM保護的內容。

[in] DrmRights

DRMRIGHTS的指標結構，指定內容提供者授與給用戶的許可權，以便在此數據流中播放和複製DRM保護的內容。

如果呼叫成功，SetContentId 會傳回STATUS_SUCCESS。否則，方法會傳回適當的錯誤碼。如果篩選條件無法強制執行指定的內容許可權，此方法會傳回STATUS_NOT_IMPLEMENTED。

DRM 系統可以在 KS 音訊串流存留期間隨時呼叫 SetContentId 方法。

KS 音訊篩選器會同步完成對 SetContentId 方法的呼叫執行。如果函式傳回STATUS_SUCCESS，這表示 KS 音訊數據流的所有下游 KS 音訊節點（請參閱音訊拓撲節點），也已成功設定指定的DRM內容標識碼和DRM內容許可權。（下游節點 一詞是指音訊數據流的直接或間接接收。

如果 KS 音訊篩選器無法強制執行指定的DRM內容許可權，SetContentId 方法會傳回錯誤碼STATUS_NOT_IMPLEMENTED。在此情況下，KS 音訊數據流先前設定的DRM內容識別碼和DRM內容許可權會保留在數據流上設定。

如需使用此方法的詳細資訊，請參閱 Digital Rights Management。