DXGKDDI_MIRACAST_CREATE_CONTEXT コールバック関数 (dispmprt.h)

  • [アーティクル]

Miracast デバイスのカーネル モード コンテキストを作成します。

構文

DXGKDDI_MIRACAST_CREATE_CONTEXT DxgkddiMiracastCreateContext;

NTSTATUS DxgkddiMiracastCreateContext(
  [in]  PVOID DriverContext,
  [in]  DXGK_MIRACAST_DISPLAY_CALLBACKS *MiracastCallbacks,
  [out] PVOID *MiracastContext,
  [out] ULONG *TargetId
)
{...}

パラメーター

[in] DriverContext

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前は DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。

[in] MiracastCallbacks

ドライバーが呼び出すことができるコールバック関数へのポインターを持つ DXGK_MIRACAST_DISPLAY_CALLBACKS 構造体を保持するオペレーティング システムが提供するバッファーへのポインター。

[out] MiracastContext

ドライバーがこの Miracast デバイス インスタンスに割り当てたコンテキストのアドレスを保持するオペレーティング システムによって提供されるバッファーへのポインター。

[out] TargetId

Miracast デバイスが接続されている VidPN ターゲットの ID を保持するオペレーティング システムによって提供されるバッファーへのポインター。 ドライバーは、オペレーティング システムがデバイス の 初期化中に DxgkDdiQueryChildRelations 関数を呼び出すときにD3DKMDT_VOT_MIRACAST型としてこのターゲットを報告する必要があります。

戻り値

成功した場合は、STATUS_SUCCESSを返します。 それ以外の場合は、Ntstatus.h で定義されている次のエラー コードのいずれかを返します。

リターン コード 説明
STATUS_RESOURCE_IN_USE Miracast 接続セッションをサポートするために必要なハードウェア リソースは、現在使用できません。

注釈

この関数が呼び出されると、ディスプレイ ミニポート ドライバーは、Miracast 接続セッションをサポートするために必要なすべてのカーネル モード リソースを準備する必要があります。

同期

オペレーティング システムは、 DxgkDdiMiracastCreateContext、 DxgkDdiMiracastDestroyContext、 DxgkDdiMiracastIoControl 関数を Miracast クラスとしてグループ化します。 オペレーティング システムでは、これらの関数がスレッド処理と同期の第 2 レベルで定義されている第 2 レベルの同期モードに従っていることを保証します。 これらの関数は、他のレベル 0、1、またはレベル 2 関数の他のクラスが別のスレッド コンテキストで呼び出されている場合に呼び出すことができます。 ただし、一度に呼び出すことができるのは、これらのレベル 2 の Miracast クラス関数のいずれか 1 つだけです。

要件

要件 値
サポートされている最小のクライアント Windows 8.1
サポートされている最小のサーバー Windows Server 2012 R2
対象プラットフォーム デスクトップ
Header dispmprt.h (Dispmprt.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

DXGK_MIRACAST_DISPLAY_CALLBACKS

DxgkDdiAddDevice

DxgkDdiQueryChildRelations