DrmForwardContentToFileObject 関数 (drmk.h)

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

関数は 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 必要があります。

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

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