DrmAddContentHandlers 函式 (drmk.h)
DrmAddContentHandlers
函式會提供系統處理受保護內容的函式清單。
語法
NTSTATUS DrmAddContentHandlers(
[in] ULONG ContentId,
[in] PVOID *paHandlers,
[in] ULONG NumHandlers
);
參數
[in] ContentId
指定DRM內容識別碼。 此參數會識別受保護的 KS 音訊數據流。
[in] paHandlers
函式指標陣列的指標。 每個數位元素都會指向內容處理程式。
[in] NumHandlers
指定 paHandlers 陣列中的函式指標數目。
傳回值
如果呼叫成功,DrmAddContentHandlers
會傳回STATUS_SUCCESS。 否則,它會傳回適當的錯誤碼。
言論
允許受保護的內容流經數據路徑之前,系統會確認數據路徑是否安全。 若要這樣做,系統會驗證數據路徑中的每個模組,從數據路徑的上游端開始,並移動下游。 當每個模組都經過驗證時,該模組會提供數據路徑中下一個模組的系統資訊,以便也可以進行驗證。 若要成功驗證,模組的二進位檔必須簽署為DRM相容。
如果兩個相鄰的模組會透過 IoCallDriver 函式或下游模組的 COM 介面彼此通訊,上游模組會分別呼叫 DrmForwardContentToInterface 或 DrmForwardContentToDeviceObject 函式,以提供系統與下游模塊的相關信息。 不過,如果兩個模組使用任何其他類型的介面進行通訊,上游模組會改為呼叫 DrmAddContentHandlers
函式。
paHandlers 數位含下游模組中進入點的函式指標。
DrmAddContentHandlers
驗證實作這些函式的模組。 (如果進入點分散在數個模組之間,函式會驗證所有這些模組。此陣列中廠商定義的函式組成了呼叫函式的模組和實作函式的模組所瞭解的介面。
DrmAddContentHandlers
不會直接呼叫上述任何函式。
上游模組可以使用 paHandlers 陣列中的其中一個函式,將內容標識碼和內容許可權傳遞至下游模組。 下游模組需要內容識別碼,以建議系統傳送受保護內容的任何模組。
DrmAddContentHandlers 會執行與 PcAddContentHandlers 和 IDrmPort2::AddContentHandlers相同的函式。 如需詳細資訊,請參閱 DRM函式和介面。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | drmk.h (包括 Drmk.h) |
連結庫 | Drmk.lib |
IRQL | PASSIVE_LEVEL |