次の方法で共有


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

メソッドは 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」を参照してください。

要件

要件
対象プラットフォーム ユニバーサル
Header drmk.h (Drmk.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

DRMRIGHTS

DrmCreateContentMixed

DrmDestroyContent

DrmForwardContentToFileObject

DrmForwardContentToInterface

DrmGetContentRights

IDrmAudioStream