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を返します。 次の表は、考えられるエラー戻り値の一部を示しています。
| リターン コード | 形容 |
|---|---|
|
FileObject に関連付けられている KS オーディオ ピンが、ContentIdに割り当てられている DRM コンテンツ権限をサポートしていないことを示します。 |
備考
この関数は、DrmForwardContentToDeviceObjectに置き換えられます。
DrmForwardContentToFileObject を呼び出すドライバーは、システムを低い DRM セキュリティ レベルで強制的に実行します。 新しいドライバーは、代わりに DrmForwardContentToDeviceObject を呼び出す必要があります。
DrmForwardContentToFileObject 関数は、FileObjectで表される KS オーディオ ピンを実装する KS オーディオ フィルターを認証します。 KS オーディオ フィルターを正常に認証 DrmForwardContentToFileObject 場合は、FileObject で表されるオーディオ ピンに KS プロパティ KSPROPERTY_DRMAUDIOSTREAM_CONTENTID設定します。 プロパティ データには、DRM コンテンツ ID と DRMRIGHTS 構造体が含まれます。
DrmForwardContentToFileObject は、返された後 FileObject を使用しません。
DrmForwardContentToFileObject は、PcForwardContentToFileObject および IDrmPort::ForwardContentToFileObjectと同じ機能を実行します。 詳細については、「DRM 関数とインターフェイスの」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | drmk.h (Drmk.h を含む) |
| ライブラリ | Drmk.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
DrmForwardContentToDeviceObject の
IDrmPort::ForwardContentToFileObject