D3DKMTConnectDoorbell 関数 (d3dkmthk.h)

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

重要

一部の情報はプレリリース製品に関連しており、商用リリース前に大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

D3DKMTConnectDoorbell は、以前に作成したドアベルをハードウェアキューに接続 (または再接続) します。

構文

NTSTATUS D3DKMTConnectDoorbell(
  D3DKMT_CONNECT_DOORBELL *unnamedParam1
);

パラメーター

unnamedParam1

[入力]接続するドアベルを記述する *D3DKMT_CONNECT_DOORBELL* 構造体へのポインター。

戻り値

D3DKMTConnectDoorbell は、OS がドアベルをハードウェアキューに正常に接続したときにSTATUS_SUCCESSを返し、UMD はこのドアベルを作業送信に使用できます。通常、この呼び出しは失敗しません。ただし、障害コードは、GPU の紛失または回復不可能なシナリオの種類の停止から発生します。

注釈

UMD がハードウェアキューに新しい作業を送信し、ドアベルを呼び出すたびに、DoorbellStatusCPUVirtualAddress を読み取って、ドアベルリングが成功したかどうかをチェックする必要があります。失敗した場合、UMD は D3DKMTConnectDoorbell を呼び出してドアベルを再接続してから、もう一度送信を試す必要があります。

ドアベルは、いくつかの理由で切断される可能性があります。

ドアベルが作成されると、OS によって "切断" 状態で初期化され、UMD が D3DKMTConnectDoorbell を初めて呼び出すときにのみ接続されます。
ドアベルは、専用のドアベルモデルをサポートするハードウェアで "被害を受けた" ものでした。つまり、このハードウェアキューの物理ドアベルは、別のハードウェアキューに割り当てられました。この再割り当ては、GPU 上に作成されるハードウェアキューが物理ドアベルよりも多いためです。
ハードウェアキューの中断または GPU の電源切断の一環として、ドアベルが切断されました。

UMD が D3DKMTConnectDoorbell を呼び出してハードウェアキューに割り当てられたドアベルを接続すると、OS は KMD に対応する DxgkDdiConnectDoorbell 呼び出しを行います。これにより、KMD は物理ドアベルを見つけ、このハードウェアキューに割り当て、ハードウェアキュー、ドアベル、GPU スケジューラなどの間で必要な接続を行うことができます。

詳細については、「ユーザーモードの作業の送信」を参照してください。