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

DxgkDdiStartDevice デバイスが呼び出される前に必要になる可能性があるため、通常の大文字またはアダプター情報 DDI を使用して照会できない、OS とドライバーの間で非常に単純なデータを交換できます。

構文

DXGKDDI_EXCHANGEPRESTARTINFO DxgkddiExchangeprestartinfo;

NTSTATUS DxgkddiExchangeprestartinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_OUT_PDXGK_PRE_START_INFO pPreStartInfo
)
{...}

パラメーター

[in] hAdapter

アダプターを識別します。

[in] pPreStartInfo

情報を渡す OS のフィールドと、ドライバーが情報を返すフィールドの両方を含む、 DXGK_PRE_START_INFO 構造体へのポインター。 最初は、 SupportPreserveBootDisplay のみが定義されます。

[out]SupportPreserveBootDisplay

ドライバーとハードウェアは、 DxgkDdiStartDevice 中に実行されるハードウェアの初期化全体でブート フレーム バッファーを使用して表示できるようにする要件をサポートします。

戻り値

このルーチンが成功し、要求された変更を返す場合は、STATUS_SUCCESSを返します。

注釈

この DDI は DxgkDdiAddDevice の後と DxgkDdiStartDevice の前に呼び出されるため、ドライバーは独自のハードウェア リソースにアクセスできません。 ただし、DxgkDdiAddDevice のドライバーに渡された PhysicalDeviceObject を使用して、IoGetDeviceProperty を呼び出すことができます。 たとえば、DXGK_PRE_START_INFO 構造体の出力フィールドで返す内容を決定するために、ハードウェア ID を見つけることができます。

この関数は常に PASSIVE レベルで呼び出されるため、サポート コードは可能な限りページング可能にする必要があります。

要件