DrmGetContentRights 関数 (drmk.h)
DrmGetContentRights 関数は、DRM コンテンツ ID に割り当てられた DRM コンテンツ権限を取得します。
構文
NTSTATUS DrmGetContentRights(
[in] ULONG ContentId,
[out] PDRMRIGHTS DrmRights
);
パラメーター
[in] ContentId
DRM コンテンツ ID を指定します。 このパラメーターは、KS オーディオ ストリームを識別します。
[out] DrmRights
ContentId によって識別されるストリームに割り当てられる DRM コンテンツ権限指定します。 このパラメーターは、DRMRIGHTS 構造体へのポインターです。
戻り値
DrmGetContentRights は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切なエラー コードが返されます。
備考
KS オーディオ フィルターは、複数の KS オーディオ ストリームの混在を開始する前に、まず DrmCreateContentMixed 呼び出して複合ストリームのコンテンツ ID を作成します。 次に、DrmGetContentRights を呼び出して、システムがストリームに割り当てたコンテンツ権限を取得します。
コンテンツ ID を作成する KS フィルターの下流にあるモジュールは、通常、DrmGetContentRightsを呼び出す必要はありません。 代わりに、モジュールは、システム (IDrmAudioStream::SetContentId 呼び出しまたは KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDset-property 要求) から、またはデータ パス内の前のモジュール (コンテンツ ハンドラーの呼び出しを介して) から直接、コンテンツ ID とコンテンツ権限の両方を受け取ります。 詳細については、「DrmForwardContentToInterface 、DrmForwardContentToDeviceObject、および drmAddContentHandlers する」を参照してください。
DrmGetContentRights は、PcGetContentRights および IDrmPort::GetContentRightsと同じ機能を実行します。 詳細については、「DRM 関数とインターフェイスの」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | drmk.h (Drmk.h を含む) |
| ライブラリ | Drmk.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
DrmAddContentHandlers を する
DrmCreateContentMixed の
DrmForwardContentToDeviceObject の
DrmForwardContentToInterface を する