DXGKDDI_VIDPNTARGETMODESET_PINMODE回呼函式 （d3dkmddi.h）

pfnPinMode 函式會在 VidPN 目標模式集中釘選指定的模式。

語法

DXGKDDI_VIDPNTARGETMODESET_PINMODE DxgkddiVidpntargetmodesetPinmode;

NTSTATUS DxgkddiVidpntargetmodesetPinmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_D3DKMDT_VIDEO_PRESENT_TARGET_MODE_ID VidPnTargetModeId
)
{...}

參數

[in] hVidPnTargetModeSet

VidPN 目標模式集物件的句柄。 顯示迷你埠驅動程式先前已呼叫 DXGK_VIDPN_INTERFACE 介面的 pfnAcquireTargetModeSet 函式，以取得此句柄。

[in] VidPnTargetModeId

識別要釘選之模式的整數。

傳回值

pfnPinMode 函式會傳回下列其中一個值：

傳回碼	描述
STATUS_SUCCESS	函式成功。
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	hVidPnTargetModeSet 中提供的句柄無效。
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE	VidPnTargetModeId 所識別的模式不屬於 hVidPnTargetModeSet 所代表的來源模式集。

言論

作系統會指派 VidPN 目標模式識別碼。 pfnCreateNewModeInfo 函式會產生模式識別碼、將標識碼指派給 D3DKMDT_VIDPN_TARGET_MODE 結構 成員 標識符，並將結構傳回至顯示迷你埠驅動程式。

D3DKMDT_HVIDPNTARGETMODESET數據類型定義於 D3dkmdt.h中。

要求

要求	價值
最低支援的用戶端	Windows Vista
目標平臺	桌面
標頭	d3dkmddi.h （包括 D3dkmddi.h）
IRQL	PASSIVE_LEVEL