drmForwardContentToFileObject 函式 (drmk.h)

發行項
02/29/2024

函 DrmForwardContentToFileObject 式已過時，而且只會維護以支援現有的驅動程式。此函式會將代表處理受保護內容的裝置的檔案對象傳送給操作系統。它也會將包含受保護內容之數據流的內容標識碼和相關聯的DRM許可權轉送至指定的裝置。

語法

NTSTATUS DrmForwardContentToFileObject(
  [in] ULONG        ContentId,
  [in] PFILE_OBJECT FileObject
);

參數

[in] ContentId

指定DRM內容識別碼。此參數會識別受保護的 KS 音訊數據流。

[in] FileObject

檔案物件的指標，代表 KS 音訊數據流所傳送的 KS 音訊釘選。

傳回值

DrmForwardContentToFileObject 如果呼叫成功，會傳回STATUS_SUCCESS。下表顯示一些可能的錯誤傳回值。

傳回碼	Description
STATUS_NOT_IMPLEMENTED	表示與 FileObject 相關聯的 KS 音訊釘選不支援指派給 ContentId 的 DRM 內容許可權。

備註

DrmForwardContentToDeviceObject 會取代此函式。呼叫 DrmForwardContentToFileObject 的驅動程式會強制系統在較低的DRM安全性層級執行。新的驅動程式應該改為呼叫 DrmForwardContentToDeviceObject 。

函 DrmForwardContentToFileObject 式會驗證 KS 音訊篩選器，以實作 FileObject 所代表的 KS 音訊釘選。如果DrmForwardContentToFileObject成功驗證 KS 音訊篩選器，它會在 FileObject 所代表的音訊釘選上設定 KS 屬性KSPROPERTY_DRMAUDIOSTREAM_CONTENTID。屬性數據報含DRM內容識別碼和 DRMRIGHTS 結構。 DrmForwardContentToFileObject 傳回之後，不會使用 FileObject 。

DrmForwardContentToFileObject 會執行與 PcForwardContentToFileObject 和 IDrmPort：：ForwardContentToFileObject 相同的函式。如需詳細資訊，請參閱 DRM函式和介面。