DrmForwardContentToFileObject 函式（drmk.h）

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

語法

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

參數

[in] ContentId

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

[in] FileObject

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

傳回值

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

傳回碼	描述
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函式和介面。