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
DRMRIGHTS 構造体へのポインター。このストリームで DRM で保護されたコンテンツを再生およびコピーするために、コンテンツ プロバイダーからユーザーに付与される権限を指定します。
戻り値
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」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | drmk.h (Drmk.h を含む) |
| IRQL | PASSIVE_LEVEL |
関連項目
DrmCreateContentMixed の
DrmDestroyContent の
DrmForwardContentToInterface を する
IDrmAudioStream の