DrmGetContentRights 函式 (drmk.h)

發行項
02/26/2024

函式 DrmGetContentRights 會擷取指派給DRM內容標識碼的DRM內容許可權。

語法

NTSTATUS DrmGetContentRights(
  [in]  ULONG      ContentId,
  [out] PDRMRIGHTS DrmRights
);

參數

[in] ContentId

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

[out] DrmRights

指定指派給 ContentId 所識別之數據流的DRM內容許可權。此參數是 DRMRIGHTS 結構的指標。

傳回值

DrmGetContentRights 如果呼叫成功，則會傳回STATUS_SUCCESS。否則，它會傳回適當的錯誤碼。

備註

在 KS 音訊篩選開始混合數個 KS 音訊串流之前，它會先呼叫 DrmCreateContentMixed 來建立復合數據流的內容識別碼。接下來，它會呼叫 DrmGetContentRights 以取得系統指派給數據流的內容許可權。

在 KS 篩選器下游的模組，建立內容識別碼通常不需要呼叫 DrmGetContentRights。相反地，模組會 (透過 IDrmAudioStream：：SetContentId 呼叫或KSPROPERTY_DRMAUDIOSTREAM_CONTENTID set-property) 要求，或直接從數據路徑中的上一個模組接收內容標識符和內容許可權， (透過呼叫內容處理程式) 。如需詳細資訊，請參閱 DrmForwardContentToInterface、 DrmForwardContentToDeviceObject 和 DrmAddContentHandlers。

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