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
ターゲット プラットフォーム の	デスクトップ
ヘッダー	dispmprt.h
IRQL	PASSIVE_LEVEL

関連項目

DxgkDdiAddDevice の

LINKED_DEVICE