DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO回呼函式 （d3dkmddi.h）
pfnAcquirePathInfo 函式會傳回視訊簡訊簡報來源所指定的視訊簡訊簡報路徑描述元，以及特定 VidPN 拓撲內的視訊呈現目標。
語法
DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}
參數
[in] hVidPnTopology
VidPN 拓撲物件的句柄。 顯示迷你埠驅動程式先前已呼叫 DXGK_VIDPN_INTERFACE 介面的 pfnGetTopology 函式，以取得此句柄。
[in] VidPnSourceId
識別影片呈現來源的整數。
[in] VidPnTargetId
識別影片呈現目標的整數。
[out] ppVidPnPresentPathInfo
變數的指標，可接收描述所要求路徑之D3DKMDT_VIDPN_PRESENT_PATH結構的指標。
傳回值
pfnAcquirePathInfo 函式會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| STATUS_SUCCESS | 函式成功。 |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology 中提供的句柄無效。 |
言論
當您完成使用 D3DKMDT_VIDPN_PRESENT_PATH 結構之後，您必須呼叫 pfnReleasePathInfo 來釋放結構。
路徑包含一組 （source， target） 配對，而拓撲是路徑的集合。 此函式會傳回路徑的描述元，其位於指定的拓撲中，其中包含指定的（來源、目標） 組。
您可以呼叫 pfnAcquireFirstPathInfo ，然後對 pfnAcquireNextPathInfo呼叫 pfnAcquireNextPathInfo，以列舉屬於 VidPN 拓撲物件的所有路徑。
作系統會指派 VidPN 來源標識碼。 顯示迷你埠驅動程式所實作的 DxgkDdiStartDevice會傳回顯示配接器所支援之視訊簡訊簡訊的數目 N。 然後作系統會指派識別碼 0、1、2、 ...N - 1.
顯示迷你埠驅動程式會指派 VidPN 目標識別碼。 DxgkDdiQueryChildRelations，由 display miniport 驅動程式實作，會傳回 DXGK_CHILD_DESCRIPTOR 結構的陣列，每個結構都包含標識符。
D3DKMDT_HVIDPNTOPOLOGY數據類型定義於 D3dkmdt.h中。
D3DDDI_VIDEO_PRESENT_SOURCE_ID和D3DDDI_VIDEO_PRESENT_TARGET_ID數據類型定義於 D3dukmdt.h中。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平臺 | 桌面 |
| 標頭 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | PASSIVE_LEVEL |