PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL コールバック関数 (d3d10umddi.h)

  • [アーティクル]

アプリケーションからの要求を処理して、コンテンツ保護用に認証済みチャネルを構成します。 Windows ディスプレイ ドライバー モデル (WDDM) 1.2 以降のユーザー モード ディスプレイ ドライバーによって実装されます。

構文

PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Pfnd3d111DdiConfigureauthenticatedchannel;

HRESULT Pfnd3d111DdiConfigureauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
  UINT InputDataSize,
  const VOID *pInputData,
  D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT *pOutputData
)
{...}

パラメーター

hDevice

ディスプレイ デバイス (グラフィックス コンテキスト) へのハンドル。

hCAuthChannel

CreateAuthenticatedChannel(D3D11_1) 関数の呼び出しによって作成された認証済みチャネル オブジェクトへのハンドル。

InputDataSize

pInputData パラメーターで指定された配列のサイズ (バイト単位)。

pInputData

コマンドの入力データを含むバイト配列へのポインター。 詳細については、「解説」を参照してください。

pOutputData

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT構造体へのポインター。 詳細については、「解説」を参照してください。

戻り値

次の値のいずれか。

リターン コード 説明
S_OK 認証されたチャネルが正常に構成されました。
E_FAIL ディスプレイ ミニポート ドライバーは、指定されたコマンドをサポートしていません
E_INVALIDARG パラメーターが検証され、正しくないと判断されました。
E_OUTOFMEMORY 操作を完了するためにメモリを使用できませんでした。

注釈

pInputData パラメーターによって参照されるバイト配列は、次のように書式設定されます。

次の一覧では、 ConfigureType メンバーに基づくこのデータの形式について説明します。

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT構造体には、データの AES ベースの 1 キー CBC メッセージ認証コード (OMAC) が含まれています。 ディスプレイ ミニポート ドライバーは、データを認証するために、データに対して独自の OMAC を計算する必要があります。 この入力構造体には、認証されたチャネルへのドライバー ハンドル、シーケンス番号、および構成の種類を示す GUID も含まれます。

ディスプレイ ミニポート ドライバーは、D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT構造体を初期化するときに、次の手順 に 従います。

  1. ドライバーは、入力データを D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT 構造体にコピーする必要があります。

  2. ドライバーは、ConfigureAuthenticatedChannel(D3D11_1) 呼び出しで返されるのと同じリターン コードに ReturnCode メンバーを設定する必要があります。 これにより、リターン コードにアクセスするための安全なメカニズムがアプリケーションに提供されます。

  3. ドライバーは、omac メンバーを 0 に設定し、構造体内のデータの OMAC を計算します。 その後、ドライバーは omac メンバーを計算した OMAC に設定します

ディスプレイ ミニポート ドライバーは、次の条件下で ConfigureAuthenticatedChannel 呼び出しのE_INVALIDARGを返す必要があります。

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT構造体の omac メンバーが、ドライバーが計算した OMAC と一致しません。

  • シーケンス番号は、前の構成呼び出しで指定されたシーケンス番号より大きくはありません。

  • シーケンス番号は、ConfigureAuthenticatedChannel(D3D11_1) 関数の呼び出しによってまだ初期化されていません。

  • InputDataSize パラメーターは、D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT構造体のサイズと 、D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT で指定された構造体のサイズより小さくなります。ConfigureTypemember。

要件

要件 値
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム デスクトップ
Header d3d10umddi.h (D3d10umddi.h を含む)

こちらもご覧ください

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT