PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL コールバック関数 (d3d10umddi.h)
認証されたチャネル オブジェクトを作成します。 Windows ディスプレイ ドライバー モデル (WDDM) 1.2 以降のユーザー モード ディスプレイ ドライバーによって実装されます。
構文
PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;
HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
D3D10DDI_HDEVICE hDevice,
D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}
パラメーター
hDevice
ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。
pCreateData
D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL構造体へのポインター。 この構造体は、作成する認証済みチャネルの属性を指定します。
hAuthChannel
認証済みチャネル オブジェクトのドライバーのプライベート データへのハンドル。 詳細については、「解説」を参照してください。
hRTAuthChannel
ドライバーが Direct3D ランタイムに呼び出すときに使用する必要がある認証済みチャネル オブジェクトへのハンドル。
戻り値
次の値のいずれか。
| リターン コード | 説明 |
|---|---|
| S_OK | 認証されたチャネルが正常に作成されました。 |
| D3DDDIERR_DEVICEREMOVED | グラフィックス アダプターが削除されました。 |
| E_OUTOFMEMORY | 操作を完了するためにメモリを使用できませんでした。 |
注釈
Direct3D ランタイムは、ドライバーの CalcPrivateAuthenticatedChannelSize を呼び出した後、CreateAuthenticatedChannel(D3D11_1) を呼び出して、ドライバーが認証されたチャネル オブジェクトに必要なプライベート データのサイズをバイト単位で決定します。 ランタイムは、ドライバーのこのプライベート データのメモリを割り当てます。 ドライバーは、このメモリを使用して、認証チャネル オブジェクトに関連するプライベート データを格納します。
ランタイムが CreateAuthenticatedChannel(D3D11_1) を呼び出すと、 hAuthChannel パラメーターのプライベート データ メモリにハンドルが渡されます。 このハンドルは、実際にはメモリへのポインターです。
ドライバーは、認証されたチャネルの作成に使用されたディスプレイ デバイスへのハンドルを追跡する必要があります。 ドライバーは、これらの呼び出しで指定されたディスプレイ デバイスが認証されたチャネルの作成に使用されたディスプレイ デバイスと異なる場合、 NegotiateAuthenticatedChannelKeyExchange など、この作成された認証チャネルを使用する後続のすべての呼び出しに失敗する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | デスクトップ |
| Header | d3d10umddi.h (D3d10umddi.h を含む) |
こちらもご覧ください
CalcPrivateAuthenticatedChannelSize
CreateAuthenticatedChannel(D3D11_1)