IDrmAudioStream::SetContentId メソッド (drmk.h)

[アーティクル]
08/07/2023

メソッドは SetContentId 、KS オーディオストリームに対する DRM コンテンツ ID とその割り当てられた DRM コンテンツ権限を設定します。

構文

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

パラメーター

[in] ContentId

DRM コンテンツ ID を指定します。このパラメーターは、DRM システムが実行時に生成して、このストリーム内の DRM で保護されたコンテンツを識別する識別子です。

[in] DrmRights

このストリーム内の DRM で保護されたコンテンツを再生およびコピーするために、コンテンツプロバイダーからユーザーに付与される権限を指定する DRMRIGHTS 構造体へのポインター。

戻り値

SetContentId は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。それ以外の場合、メソッドは適切なエラーコードを返します。フィルターで指定したコンテンツ権限を適用できない場合、メソッドは STATUS_NOT_IMPLEMENTEDを返します。

注釈

DRM システムは、KS オーディオストリームの有効期間中にいつでもメソッドを呼び出 SetContentId すことができます。

KS オーディオフィルターは、メソッドの呼び出しの実行を SetContentId 同期的に完了します。関数がSTATUS_SUCCESSを返す場合は、KS オーディオストリームのすべてのダウンストリーム KS オーディオノード ( 「オーディオトポロジノード」を参照) も、指定された DRM コンテンツ ID と DRM コンテンツ権限で正常に構成されていることを示します。 ( ダウンストリームノード という用語は、オーディオストリームの直接シンクまたは間接シンクを指します)。

KS オーディオフィルターで指定した DRM コンテンツ権限を適用できない場合、メソッドは SetContentId エラーコード STATUS_NOT_IMPLEMENTEDを返します。この場合、KS オーディオストリームの以前に設定された DRM コンテンツ ID と DRM コンテンツ権限は、ストリームに設定されたままです。

この方法の使用方法の詳細については、「 Digital Rights Management」を参照してください。