DrmAddContentHandlers 函式 (drmk.h)

發行項
02/26/2024

函 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 驗證實作這些函式的模組。 (如果進入點分散在數個模組之間，函式會驗證所有這些modules.) 此陣列中的廠商定義函式會構成呼叫函式的模組和實作函式的模組所瞭解的介面。 DrmAddContentHandlers 不會直接呼叫上述任何函式。

上游模組可以使用 paHandlers 數位列中的其中一個函式，將內容識別碼和內容許可權傳遞至下游模組。下游模組需要內容識別碼，以建議系統傳送受保護內容的任何模組。

DrmAddContentHandlers 會執行與 PcAddContentHandlers 和 IDrmPort2：：AddContentHandlers 相同的函式。如需詳細資訊，請參閱 DRM函式和介面。