Funzione DrmCreateContentMixed (drmk.h)

Articolo
08/07/2023

La DrmCreateContentMixed funzione crea un ID contenuto DRM per identificare un flusso audio KS contenente contenuto misto da un numero di flussi.

Sintassi

NTSTATUS DrmCreateContentMixed(
  [in]  PULONG paContentId,
  [in]  ULONG  cContentId,
  [out] PULONG pMixedContentId
);

Parametri

[in] paContentId

Puntatore a una matrice di ID contenuto DRM. Ogni elemento matrice è di tipo ULONG e contiene un ID contenuto che rappresenta un flusso audio KS protetto. Se cContentId è zero, paContentID può essere NULL. Un ID contenuto pari a zero è un valore speciale che rappresenta un flusso audio con diritti di contenuto DRM predefiniti (vedere DEFINE_DRMRIGHTS_DEFAULT).

[in] cContentId

Specifica il numero di ID contenuto DRM nella matrice paContentId . La matrice può contenere zero o più ID contenuto.

[out] pMixedContentId

Puntatore di output per l'ID contenuto composito. Questo parametro punta a una variabile ULONG allocata dal chiamante in cui la funzione scrive il nuovo ID contenuto per il flusso audio KS composito. Se cContentId è zero, la funzione assegna i diritti di contenuto DRM predefiniti al nuovo ID contenuto.

Valore restituito

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

Commenti

Un filtro audio KS chiama la DrmCreateContentMixed funzione per ottenere un ID contenuto DRM per un flusso composito. Il filtro produce questo flusso combinando i flussi audio KS i cui ID contenuto sono elencati nella matrice paContentId . Dato questo elenco di ID contenuto per i flussi in input del mixer, la funzione calcola i diritti di contenuto del flusso composito e assegna un nuovo ID contenuto a tale flusso.

Se il chiamante non specifica alcun ID contenuto, ovvero se cContentId è zero, la funzione assegna i diritti di contenuto predefiniti all'ID contenuto creato per identificare il flusso composito.

Dopo aver ottenuto un ID contenuto da DrmCreateContentMixed, il chiamante può ottenere i diritti di contenuto assegnati all'ID contenuto chiamando DrmGetContentRights.

Dopo una modifica ai diritti di contenuto di uno dei componenti di un flusso audio composito, il filtro audio KS che combina il flusso deve chiamare DrmCreateContentMixed per ottenere un nuovo ID contenuto per il flusso audio composito. DrmCreateContentMixed determina i diritti di contenuto più restrittivi assegnati ai singoli ID contenuto specificati nella matrice paContentId e assegna questi diritti al nuovo ID contenuto.

Dopo aver completato un filtro audio KS usando un ID contenuto creato tramite DrmCreateContentMixed, il filtro deve chiamare DrmDestroyContent per eliminare l'ID contenuto. Tuttavia, prima di eliminare un ID contenuto precedente, il filtro audio KS deve prima inoltrare correttamente un nuovo ID contenuto a tutti i flussi a cui in precedenza ha inoltrato l'ID contenuto precedente. Il filtro audio KS inoltra un ID contenuto chiamando una funzione DrmForwardContentToXxx .

DrmCreateContentMixed esegue la stessa funzione di PcCreateContentMixed e IDrmPort::CreateContentMixed. Per altre informazioni, vedere Funzioni e interfacce DRM.