Metodo IDrmAudioStream::SetContentId (drmk.h)
Il metodo SetContentId imposta l'ID contenuto DRM e i 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 contenuto protetto da DRM in questo flusso.
Valore restituito
SetContentId restituisce STATUS_SUCCESS se la chiamata ha avuto 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.
Osservazioni
Il sistema DRM può chiamare il metodo SetContentId in qualsiasi momento durante la durata di un flusso audio KS.
Un filtro audio KS completa in modo sincrono l'esecuzione di una chiamata al metodo SetContentId. Se la funzione restituisce STATUS_SUCCESS, questo indica che anche tutti i nodi audio KS downstream (vedere nodi topologia audio) di un flusso audio KS sono stati configurati correttamente con l'ID contenuto DRM e i diritti di contenuto 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 metodo SetContentId 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | drmk.h (include Drmk.h) |
| IRQL | PASSIVE_LEVEL |