DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO回呼函式 （d3dkmddi.h）
pfnAcquireFirstModeInfo 函式會傳回指定 VidPN 目標模式集中第一個模式的描述元。
語法
DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpntargetmodesetAcquirefirstmodeinfo;
NTSTATUS DxgkddiVidpntargetmodesetAcquirefirstmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppFirstVidPnTargetModeInfo
)
{...}
參數
[in] hVidPnTargetModeSet
VidPN 目標模式集物件的句柄。 顯示迷你埠驅動程式先前已呼叫 DXGK_VIDPN_INTERFACE 介面的 pfnAcquireTargetModeSet 函式，以取得此句柄。
[out] ppFirstVidPnTargetModeInfo
接收 D3DKMDT_VIDPN_TARGET_MODE 結構的指標之變數指標。 結構包含各種目標模式的相關信息，包括其標識符和視訊訊訊特性。
傳回值
pfnAcquireFirstModeInfo 函式會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| STATUS_SUCCESS | 函式成功。 |
| STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET | hVidPnTargetModeSet 中提供的句柄無效。 |
言論
當您完成使用 D3DKMDT_VIDPN_TARGET_MODE 結構之後，您必須呼叫 pfnReleaseModeInfo 來釋放結構。
您可以呼叫 pfnAcquireFirstModeInfo ，然後對 pfnAcquireNextModeInfo呼叫 pfnAcquireNextModeInfo，以列舉屬於 VidPN 目標模式集物件的所有模式。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平臺 | 桌面 |
| 標頭 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | PASSIVE_LEVEL |