Funzione DrmGetContentRights (drmk.h)

Articolo
02/06/2025

La funzione DrmGetContentRights recupera i diritti di contenuto DRM assegnati a un ID contenuto DRM.

Sintassi

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

Parametri

[in] ContentId

Specifica l'ID contenuto DRM. Questo parametro identifica un flusso audio KS.

[out] DrmRights

Specifica i diritti di contenuto DRM assegnati al flusso identificato da ContentId. Questo parametro è un puntatore a una struttura DRMRIGHTS.

Valore restituito

DrmGetContentRights restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.

Osservazioni

Prima che un filtro audio KS inizi a combinare diversi flussi audio KS, chiama prima DrmCreateContentMixed per creare un ID contenuto per il flusso composito. Chiama quindi DrmGetContentRights per ottenere i diritti di contenuto assegnati dal sistema al flusso.

Un modulo che si trova a valle dal filtro KS che crea l'ID contenuto in genere non deve chiamare DrmGetContentRights. Il modulo riceve invece sia l'ID contenuto che i diritti di contenuto dal sistema (tramite un IDrmAudioStream::SetContentId chiamata o una richiesta di proprietà set KSPROPERTY_DRMAUDIOSTREAM_CONTENTID) o direttamente dal modulo precedente nel percorso dati (tramite una chiamata a un gestore del contenuto). Per altre informazioni, vedere DrmForwardContentToInterface, DrmForwardContentToDeviceObjecte DrmAddContentHandlers.

DrmGetContentRights esegue la stessa funzione di PcGetContentRights e IDrmPort::GetContentRights. Per altre informazioni, vedere funzioni DRM e interfacce.