(drmk.h) IDrmAudioStream：：SetContentId 方法

發行項
02/26/2024

方法 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。