DXGKDDI_VIDPN_GETTOPOLOGY コールバック関数 (d3dkmddi.h)

  • [アーティクル]

pfnGetTopology 関数は、指定された VidPN オブジェクトに含まれる VidPN トポロジ オブジェクトへのハンドルを返します。

構文

DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;

NTSTATUS DxgkddiVidpnGettopology(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}

パラメーター

[in] hVidPn

VidPN オブジェクトへのハンドル。 VidPN マネージャーは、以前に DxgkDdiEnumVidPnCofuncModality、 DxgkDdiIsSupportedVidPn、または DxgkDdiRecommendFunctionalVidPn を呼び出すことによって、ディスプレイ ミニポート ドライバーにこのハンドルを提供しました。

[out] phVidPnTopology

VidPN トポロジ オブジェクトへのハンドルを受け取る変数へのポインター。

[out] ppVidPnTopologyInterface

DXGK_VIDPNTOPOLOGY_INTERFACE構造体へのポインターを受け取る変数へのポインター。 構造体には、ディスプレイ ミニポート ドライバーが VidPN トポロジ オブジェクトを検査および変更するために呼び出すことができる関数へのポインターが含まれています。

戻り値

pfnGetTopology 関数は、次のいずれかの値を返します。

リターン コード 説明
STATUS_SUCCESS 関数が正常に実行されました。
STATUS_GRAPHICS_INVALID_VIDPN hVidPn で指定されたハンドルが無効です。

注釈

ディスプレイ ミニポート ドライバーは、 phVidPnTopology で受け取るハンドルを解放する必要はありません。

ppVidPnTopologyInterface で返されるDXGK_VIDPNTOPOLOGY_INTERFACE構造体の有効期間は、オペレーティング システムによって所有されます。 この所有権スキームを使用すると、オペレーティング システムは、インターフェイスのクライアントを中断することなく、実行時に新しい実装に移行できます。

要件

要件 値
サポートされている最小のクライアント Windows Vista
対象プラットフォーム デスクトップ
Header d3dkmddi.h (D3dkmddi.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

DXGK_VIDPNTOPOLOGY_INTERFACE

VidPN トポロジ インターフェイス