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

オプションの DxgkDdiLinkDevice 関数は、リンクされたアダプター構成に関する情報を表示ミニポート ドライバーに照会します。

構文

DXGKDDI_LINK_DEVICE DxgkddiLinkDevice;

NTSTATUS DxgkddiLinkDevice(
  [in]      IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PLINKED_DEVICE LinkedDevice
)
{...}

パラメーター

[in] PhysicalDeviceObject

ディスプレイ アダプターを識別する物理デバイス オブジェクト (PDO) へのポインター。

[in] MiniportDeviceContext

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

[in, out] LinkedDevice

リンクされたディスプレイ アダプター構成に関する情報を含む LINKED_DEVICE構造体への ポインター。

戻り値

DxgkDdiLinkDevice は STATUS_SUCCESSを返します。リンクされたアダプター構成に関する情報を取得できない場合は、適切なエラー コードを返します。

注釈

DxgkDdiLinkDevice 関数は、リンクされたディスプレイ アダプターをサポートするディスプレイ アダプターのドライバーによって実装する必要があります。

この関数が指定されている場合、オペレーティング システムは DxgkDdiAddDevice への呼び出しが行われた直後に、リンクされたアダプター構成のディスプレイ ミニポート ドライバーに対してクエリを実行します。

オペレーティング システムが LinkedDevice が指す構造体内のすべての予期される表示アダプターを列挙しない場合、システムは VGA モードで起動します。

ドライバーは、リンクされたディスプレイ アダプターのチェーン内の 1 つの先頭リンクのみを列挙できます。

プラグ アンド プレイまたは電源イベントを使用すると、リンクされたアダプターが、残りのリンク アダプターの後に起動または起動します。逆に、このようなイベントにより、リンクされたアダプターの電源が切れたり、残りのリンク アダプターの前に無効になったりします。

要件

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

こちらもご覧ください

DxgkDdiAddDevice

LINKED_DEVICE