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 函式會傳回下列其中一個值:

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

備註

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

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

規格需求

需求
最低支援的用戶端 Windows Vista
目標平台 桌面
標頭 d3dkmddi.h (包含 D3dkmddi.h)
IRQL PASSIVE_LEVEL