次の方法で共有

DXGKDDI_VIDPN_ACQUIRESOURCEMODESET コールバック関数 (d3dkmddi.h)

  • [アーティクル]

pfnAcquireSourceModeSet 関数は、指定した VidPN オブジェクトに含まれる特定のソース モード セット オブジェクトへのハンドルを返します。

構文

DXGKDDI_VIDPN_ACQUIRESOURCEMODESET DxgkddiVidpnAcquiresourcemodeset;

NTSTATUS DxgkddiVidpnAcquiresourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

パラメーター

[in] hVidPn

VidPN オブジェクトへのハンドル。 VidPN マネージャーは、以前に、DxgkDdiEnumVidPnCofuncModality 、DxgkDdiIsSupportedVidPn、または DxgkDdiRecommendFunctionalVidPn を呼び出すことによって、ディスプレイ ミニポート ドライバーにこのハンドルを提供しました。

[in] VidPnSourceId

VidPN オブジェクトに関連付けられているビデオの現在のソースのいずれかを識別する整数。

[out] phVidPnSourceModeSet

要求されたソース モード セット オブジェクトへのハンドルを受け取る変数へのポインター。

[out] ppVidPnSourceModeSetInterface

DXGK_VIDPNSOURCEMODESET_INTERFACE 構造体へのポインターを受け取る変数へのポインター。 この構造体には、ディスプレイ ミニポート ドライバーがソース モード セット オブジェクトを検査および変更するために呼び出すことができる関数へのポインターが含まれています。

戻り値

pfnAcquireSourceModeSet 関数は、次のいずれかの値を返します。

リターン コード 形容
STATUS_SUCCESS 関数は成功しました。
STATUS_GRAPHICS_INVALID_VIDPN hVidPn で指定されたハンドルが無効でした。
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_SOURCE VidPnSourceId で指定された識別子が無効でした。

備考

VidPN ソース識別子は、オペレーティング システムによって割り当てられます。 DxgkDdiStartDevice 、ディスプレイ ミニポート ドライバーによって実装され、ディスプレイ アダプターでサポートされているビデオの現在のソースの数 N を返します。 次に、オペレーティング システムによって識別子 0、1、2、..が割り当てられます。N - 1。

ソース モード セット オブジェクト ハンドルの使用が完了したら、pfnReleaseSourceModeSet 呼び出してハンドルを解放する必要があります。 ソース モード セット オブジェクトは参照カウントされるため、ハンドルを複数回取得する場合は、同じ回数だけ解放する必要があります。

ppVidPnSourceModeSetInterface 返される DXGK_VIDPNSOURCEMODESET_INTERFACE 構造体の有効期間は、オペレーティング システムによって所有されます。 この所有権スキームを使用すると、オペレーティング システムは、インターフェイスのクライアントを中断することなく、実行時に新しい実装に切り替えることができます。

D3DDDI_VIDEO_PRESENT_SOURCE_IDデータ型は、D3dukmdt.hで定義されます。

D3DKMDT_HVIDPNとD3DKMDT_HVIDPNSOURCEMODESETのデータ型は、D3dkmdt.hで定義されます。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista
ターゲット プラットフォーム の デスクトップ
ヘッダー d3dkmddi.h (D3dkmddi.h を含む)
IRQL PASSIVE_LEVEL

関連項目

VidPN ソース モード セット インターフェイス

pfnAssignTargetModeSet を する

pfnCreateNewSourceModeSet の

pfnReleaseTargetModeSet を する