Funzione DrmGetContentRights (drmk.h)

Articolo
02/26/2024

La DrmGetContentRights funzione 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 esito positivo. In caso contrario, restituisce un codice di errore appropriato.

Commenti

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. Successivamente, chiama DrmGetContentRights per ottenere i diritti di contenuto assegnati al 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 una chiamata IDrmAudioStream::SetContentId o una richiesta di proprietà impostata KSPROPERTY_DRMAUDIOSTREAM_CONTENTID) o direttamente dal modulo precedente nel percorso dati (tramite una chiamata a un gestore del contenuto). Per altre informazioni, vedere DrmForwardContentToInterface, DrmForwardContentToDeviceObject e DrmAddContentHandlers.

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