Metodo IDrmAudioStream::SetContentId (drmk.h)

Articolo
08/07/2023

Il SetContentId metodo imposta l'ID contenuto DRM e i relativi diritti di contenuto DRM assegnati in un flusso audio KS.

Sintassi

NTSTATUS SetContentId(
  [in] ULONG       ContentId,
  [in] PCDRMRIGHTS DrmRights
);

Parametri

[in] ContentId

Specifica l'ID contenuto DRM. Questo parametro è un identificatore generato dal sistema DRM in fase di esecuzione per identificare il contenuto protetto da DRM in questo flusso.

[in] DrmRights

Puntatore a una struttura DRMRIGHTS che specifica i diritti concessi dal provider di contenuti all'utente per la riproduzione e la copia di contenuti protetti da DRM in questo flusso.

Valore restituito

SetContentId restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato. Se il filtro non può applicare i diritti di contenuto specificati, il metodo restituisce STATUS_NOT_IMPLEMENTED.

Commenti

Il sistema DRM può chiamare il SetContentId metodo in qualsiasi momento durante la durata di un flusso audio KS.

Un filtro audio KS completa l'esecuzione di una chiamata al SetContentId metodo in modo sincrono. Se la funzione restituisce STATUS_SUCCESS, questo indica che tutti i nodi audio KS downstream (vedere Nodi topologia audio) di un flusso audio KS sono stati configurati correttamente con i diritti di contenuto DRM e DRM specificati. Il termine nodo downstream fa riferimento a un sink diretto o indiretto per un flusso audio.

Se il filtro audio KS non può applicare i diritti di contenuto DRM specificati, il SetContentId metodo restituisce il codice di errore STATUS_NOT_IMPLEMENTED. In questo caso, il flusso audio KS ha precedentemente impostato l'ID contenuto DRM e i diritti di contenuto DRM rimangono impostati nel flusso.

Per altre informazioni sull'uso di questo metodo, vedere Digital Rights Management.