DXGKCB_EXCLUDE_ADAPTER_ACCESS コールバック関数 (dispmprt.h)

[アーティクル]
05/23/2024

DxgkCbExcludeAdapterAccess 関数は、ディスプレイアダプターへのすべてのアクセスを禁止し、この保護された状態にある間に指定された DxgkProtectedCallback コールバックルーチンを呼び出します。

構文

DXGKCB_EXCLUDE_ADAPTER_ACCESS DxgkcbExcludeAdapterAccess;

NTSTATUS DxgkcbExcludeAdapterAccess(
  [in] HANDLE DeviceHandle,
  [in] ULONG Attributes,
  [in] DXGKDDI_PROTECTED_CALLBACK DxgkProtectedCallback,
  [in] PVOID ProtectedCallbackContext
)
{...}

パラメーター

[in] DeviceHandle

ディスプレイアダプターを表すハンドル。ディスプレイミニポートドライバーは、DxgkDdiStartDevice に渡されたDXGKRNL_INTERFACE構造体の DeviceHandle メンバーでこのハンドルを取得しました。

[in] Attributes

ビデオメモリ操作を示す値。このパラメーターは、DXGK_EXCLUDE_EVICT_ALLとDXGK_EXCLUDE_CALL_SYNCHRONOUSが相互に排他的であることを除き、次のビットフラグ値の任意の組み合わせにすることができます。これらの値は Dispmprt.h で定義されています。

DXGK_EXCLUDE_EVICT_ALL

アダプター内のすべてのビデオメモリがシステムメモリにコピーされます。これは高価な操作です。 Attributes パラメーターがこの値に設定されていない場合、システムメモリ内のロックされたサーフェスへのアクセスは中断されます。

DXGK_EXCLUDE_CALL_SYNCHRONOUS

呼び出し元と同じスレッドコンテキストで、保護された DxgkProtectedCallback ドライバーコールバックルーチンを実行します。呼び出し元は、第 2 レベルまたは第 3 レベルの同期 DDI 呼び出しからを呼び出している必要があります。それ以外の場合、 DxgkCbExcludeAdapterAccess 関数は失敗します。

DXGK_EXCLUDE_BRIDGE_ACCESS

ドライバーがルートポート構成スペースにアクセスする必要がある場合に、PCI Express (PCIe) ルートポートへのアクセスを保護します。 DataType パラメーターを DXGK_WHICHSPACE_BRIDGE に設定して DxgkCbReadDeviceSpace 関数または DxgkCbWriteDeviceSpace 関数を呼び出す前に、Attributes パラメーターをこの値に設定します。

[in] DxgkProtectedCallback

アダプターへのすべてのアクセスが停止したときにコールバックルーチンが呼び出されます。

[in] ProtectedCallbackContext

DxgkProtectedCallback コールバックルーチンの ProtectedCallbackContext パラメーターに渡す値へのポインター。

戻り値

DxgkCbExcludeAdapterAccess は、成功した場合STATUS_SUCCESSを返します。それ以外の場合は、 Ntstatus.h で定義されているエラーコードのいずれかを返します。

注釈

アプリケーション要求は、この関数が返されるまでブロックされます。この保護状態では、指定された DxgkProtectedCallback コールバックルーチンは IRQL = PASSIVE_LEVELで呼び出されます。

DxgkCbExcludeAdapterAccess は、ディスプレイアダプターとすべてのリンクに対するグラフィックス関連の I/O 操作を防ぐために、排他的なアダプターアクセスを取得します。これにより、呼び出しの間、GPU が実質的にアイドル状態になります。

また、 Attributes パラメーターでDXGK_EXCLUDE_BRIDGE_ACCESSが指定されている場合、この関数は PCI Express (PCIe) ルートポートへのすべての PCI 構成領域アクセスを防止します。

ドライバーは、 DxgkProtectedCallback コールバックルーチンが返されるのを待って、呼び出し元スレッドの継続的な実行をブロックしないでください。たとえば、ドライバーは、コールバックルーチンを処理する非同期ワーカースレッドをスケジュールできます。

このアプリケーション要求のブロックの例外は、ユーザーモードのディスプレイドライバーが pfnLockCb 関数の呼び出しで、D3DDDICB_LOCKFLAGS構造体の Flags メンバーに UseAlternateVA ビットフィールドフラグを設定した場合に発生します。 DxgkCbExcludeAdapterAccess は、この種類の割り当てロックをブロックせず、保護されたコールバックルーチンの実行中に CPU がディスプレイアダプターにアクセスできます。

メモUseAlternateVA が pfnLockCb の呼び出しで設定されている場合、ディスプレイミニポートドライバーは DxgkCbExcludeAdapterAccess を呼び出さないでください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
対象プラットフォーム	デスクトップ
Header	dispmprt.h (Dispmprt.h を含む)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

DxgkProtectedCallback

次の方法で共有