DrmGetContentRights 関数 (drmk.h)

[アーティクル]
02/26/2024

関数は 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 関数とインターフェイス」を参照してください。