DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO コールバック関数 (d3dkmddi.h)
pfnAcquireFirstPathInfo 構造体は、指定された VidPN トポロジ オブジェクトの最初のパスの記述子を返します。
構文
DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO DxgkddiVidpntopologyAcquirefirstpathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirefirstpathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppFirstVidPnPresentPathInfo
)
{...}
パラメーター
[in] hVidPnTopology
VidPN トポロジ オブジェクトへのハンドル。 ディスプレイ ミニポート ドライバーは、DXGK_VIDPN_INTERFACE インターフェイスのpfnGetTopology 関数を呼び出すことによって、以前にこのハンドルを取得しました。
[out] ppFirstVidPnPresentPathInfo
D3DKMDT_VIDPN_PRESENT_PATH構造体へのポインターを受け取る変数へのポインター。 構造体には、パスのソース識別子やターゲット識別子など、パスに関するさまざまな情報が含まれています。
戻り値
pfnAcquireFirstPathInfo 関数は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| STATUS_SUCCESS | 関数が正常に実行されました。 |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology で指定されたハンドルが無効でした。 |
注釈
D3DKMDT_VIDPN_PRESENT_PATH構造体の使用が完了したら、 pfnReleasePathInfo を呼び出して構造体を解放する必要があります。
VidPN トポロジ オブジェクトに属するすべてのパスを列挙するには、 pfnAcquireFirstPathInfo を呼び出し、 pfnAcquireNextPathInfo を一連の呼び出しを行います。
D3DKMDT_HVIDPNTOPOLOGYデータ型は D3dkmdt.h で定義されています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | d3dkmddi.h (D3dkmddi.h を含む) |
| IRQL | PASSIVE_LEVEL |