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 |