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

[アーティクル]
02/23/2024

Miracast デバイスのインスタンスを破棄します。

構文

DXGKDDI_MIRACAST_DESTROY_CONTEXT DxgkddiMiracastDestroyContext;

void DxgkddiMiracastDestroyContext(
  [in] PVOID DriverContext,
  [in] PVOID MiracastContext
)
{...}

パラメーター

[in] DriverContext

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

[in] MiracastContext

オペレーティングシステムによって提供される Miracast デバイスコンテキスト。このコンテキストは、 DxgkDdiMiracastCreateContext 関数の呼び出しでドライバーによって以前に提供されていました。

戻り値

なし

解説

この関数が呼び出されると、ディスプレイミニポートドライバーは、DxgkDdiMiracastCreateContext 関数を処理したときに割り当てられたすべてのカーネルモードリソースを解放する必要があり、すぐにモニターの出発ホットプラグ検出 (HPD) 認識値をオペレーティングシステムに送信する必要があります。

オペレーティングシステムは、この関数を呼び出した後、 DxgkDdiMiracastIoControl 関数をこれ以上呼び出さないことを保証します。

DxgkDdiCommitVidPn 関数が完了する前に Miracast デバイスが切断されている場合、現在の操作がこの Miracast ターゲットで実行されている間、ディスプレイミニポートドライバーはユーザーモードの Miracast ドライバーにデータを送信しないでください。

ユーザーモードの StopMiracastSession 関数の完了に時間がかかりすぎる場合、オペレーティングシステムは、ユーザーモード Miracast ドライバーの実行中に DxgkDdiMiracastDestroyContext を呼び出します。この場合、オペレーティングシステムは、ユーザーモードの MiracastIoControl 関数へのそれ以上の呼び出しをブロックします。

同期

オペレーティングシステムは、 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