DrmForwardContentToFileObject 関数 (drmk.h)

この DrmForwardContentToFileObject 関数は古く、既存のドライバーをサポートするためにのみ保持されます。 この関数は、保護されたコンテンツを処理するデバイスを表すファイル オブジェクトをオペレーティング システムに送信します。 また、保護されたコンテンツを含むストリームのコンテンツ ID と関連付けられた DRM 権限を、指定されたデバイスに転送します。

構文

NTSTATUS DrmForwardContentToFileObject(
  [in] ULONG        ContentId,
  [in] PFILE_OBJECT FileObject
);

パラメーター

[in] ContentId

DRM コンテンツ ID を指定します。 このパラメーターは、保護された KS オーディオ ストリームを識別します。

[in] FileObject

KS オーディオ ストリームの送信先となる KS オーディオ ピンを表すファイル オブジェクトへのポインター。

戻り値

DrmForwardContentToFileObject は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 次の表は、考えられるエラーの戻り値の一部を示しています。

リターン コード 説明
STATUS_NOT_IMPLEMENTED
FileObject に関連付けられている KS オーディオ ピンが、ContentId に割り当てられている DRM コンテンツ権限をサポートしていないことを示します。

注釈

この関数は DrmForwardContentToDeviceObject に置き換えられます。 呼び出しを行 DrmForwardContentToFileObject うドライバーは、より低い DRM セキュリティ レベルでシステムを強制的に実行します。 代わりに新しいドライバーを呼び出す DrmForwardContentToDeviceObject 必要があります。

この関数は DrmForwardContentToFileObjectFileObject で表される KS オーディオ ピンを実装する KS オーディオ フィルターを認証します。 DrmForwardContentToFileObject KS オーディオ フィルターが正常に認証されると、FileObject で表されるオーディオ ピンに KS プロパティ KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDが設定されます。 プロパティ データには、DRM コンテンツ ID と DRMRIGHTS 構造体が含まれます。 DrmForwardContentToFileObject は、返された後 に FileObject を 使用しません。

DrmForwardContentToFileObjectは、PcForwardContentToFileObject および IDrmPort::ForwardContentToFileObject と同じ関数を実行します。 詳細については、「 DRM 関数とインターフェイス」を参照してください。

要件

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

こちらもご覧ください

DRMRIGHTS

DrmForwardContentToDeviceObject

IDrmPort::ForwardContentToFileObject

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcForwardContentToFileObject