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

[アーティクル]
08/07/2023

DxgkDdiStartDevice 関数は、I/O 要求を受信するディスプレイアダプターを準備します。

構文

DXGKDDI_START_DEVICE DxgkddiStartDevice;

NTSTATUS DxgkddiStartDevice(
  [in]  IN_CONST_PVOID MiniportDeviceContext,
  [in]  IN_PDXGK_START_INFO DxgkStartInfo,
  [in]  IN_PDXGKRNL_INTERFACE DxgkInterface,
  [out] OUT_PULONG NumberOfVideoPresentSources,
  [out] OUT_PULONG NumberOfChildren
)
{...}

パラメーター

[in] MiniportDeviceContext

ディスプレイアダプターに関連付けられているコンテキストブロックへのハンドル。ディスプレイミニポートドライバーの DxgkDdiAddDevice 関数は、以前は DirectX グラフィックスカーネルサブシステムにこのハンドルを提供しました。

[in] DxgkStartInfo

ディスプレイミニポートドライバーが初期化に必要な情報を含むDXGK_START_INFO構造体へのポインター。

[in] DxgkInterface

ディスプレイミニポートドライバーが呼び出すことができる DirectX グラフィックスカーネルサブシステムによって実装される関数へのポインターを含む DXGKRNL_INTERFACE構造体へのポインター。

[out] NumberOfVideoPresentSources

ディスプレイアダプターでサポートされているビデオ存在ソースの数を受け取る ULONG 変数へのポインター。ビデオの現在のソースの詳細については、「複数のモニターとビデオの現在のネットワーク」を参照してください。

[out] NumberOfChildren

MiniportDeviceContext で表されるディスプレイアダプターの子であるデバイスの合計数を受け取る ULONG 変数へのポインター。この数には、潜在的な子デバイスと、現在存在する子デバイスが含まれている必要があります。たとえば、ポータブルコンピューターをドッキングすると、追加のビデオ出力が使用可能になる場合、ポータブルコンピューターが現在ドッキングされているかどうかに関係なく、それらのビデオ出力をカウントする必要があります。子デバイスの詳細については、「ディスプレイアダプターの子デバイス」を参照してください。

戻り値

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

注釈

DxgkDdiStartDevice 関数は、次のアクションを実行する必要があります。

DxgkInterface パラメーターに渡されたDXGKRNL_INTERFACE構造体によって提供される関数ポインターを保存します。また、DXGKRNL_INTERFACE構造体の DeviceHandle メンバーを保存します。DirectX グラフィックスカーネルサブシステムにコールバックするには、そのハンドルが必要です。
DXGK_DEVICE_INFO構造体を割り当て、DxgkCbGetDeviceInformation を呼び出して、レジストリパス、PDO、および MiniportDeviceContext で表される表示アダプターの翻訳されたリソースの一覧を含む、その構造体のメンバーを入力します。 DXGK_DEVICE_INFO構造体の選択したメンバー (ディスプレイミニポートドライバーが後で必要とするメンバー) を、MiniportDeviceContext で表されるコンテキストブロックに保存します。
DxgkCbMapMemory 関数を呼び出して、メモリリソースをシステム空間にマップします。
I/O 要求を受信するハードウェアを準備するために必要な状態で 、MiniportDeviceContext で表されるコンテキストブロックを初期化します。
NumberOfVideoPresentSources を、MiniportDeviceContext で表されるディスプレイアダプターでサポートされているビデオ存在ソースの数に設定します。
NumberOfChildren を、MiniportDeviceContext で表されるディスプレイアダプターの子である (または子になる可能性がある) デバイスの数に設定します。
MiniportDeviceContext で表されるディスプレイアダプターの割り込みを有効にします。

Windows ディスプレイドライバーモデル (WDDM) 1.2 以降では、ディスプレイミニポートドライバーは DxgkCbAcquirePostDisplayOwnership 関数を呼び出して、ファームウェアとシステムローダーによって以前に設定された表示モードに関する情報を取得します。 DxgkCbAcquirePostDisplayOwnership が STATUS_SUCCESS で返された場合、ドライバーは DisplayInfo パラメーターで返された表示モード情報に基づいて、ディスプレイを再初期化する必要があるかどうかを判断します。それ以外の場合、ドライバーは、特定の表示モードがデバイスで現在有効になっていると想定せず、ディスプレイを初期化する必要があります。

DxgkDdiStartDevice 関数をページング可能にする必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降で使用できます。
対象プラットフォーム	デスクトップ
Header	dispmprt.h
IRQL	PASSIVE_LEVEL