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

[アーティクル]
08/07/2023

MiracastIoControl 関数に対するユーザーモードディスプレイドライバーの呼び出しに応答して、ディスプレイミニポートドライバーが同期 I/O 制御要求を処理するように要求するために、オペレーティングシステムによって呼び出されます。

構文

DXGKDDI_MIRACAST_HANDLE_IO_CONTROL DxgkddiMiracastHandleIoControl;

NTSTATUS DxgkddiMiracastHandleIoControl(
  [in]  PVOID DriverContext,
  [in]  PVOID MiracastContext,
  [in]  ULONG InputBufferSize,
  [in]  VOID *pInputBuffer,
  [in]  ULONG OutputBufferSize,
  [out] VOID *pOutputBuffer,
  [out] ULONG *BytesReturned
)
{...}

パラメーター

[in] DriverContext

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

[in] MiracastContext

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

[in] InputBufferSize

pInputBuffer が指す入力バッファーのサイズ (バイト単位) としてオペレーティングシステムによって提供されます。この値は、ユーザーモードの MiracastIoControl 関数の InputBufferSize パラメーターとして生成されます。

[in] pInputBuffer

入力バッファーへのポインターとしてオペレーティングシステムによって提供されます。この値は、ユーザーモードの MiracastIoControl 関数の InputBufferSize パラメーターとして生成されます。

InputBufferSize は、バッファーのサイズを指定します。

[in] OutputBufferSize

オペレーティングシステムによって、 pOutputBuffer によって指される出力バッファーのサイズ (バイト単位) として提供されます。

この値は、ユーザーモードの MiracastIoControl 関数の OutputBufferSize パラメーターとして生成されます。

[out] pOutputBuffer

出力バッファーへのポインターとしてオペレーティングシステムによって提供されます。この値は、ユーザーモードの MiracastIoControl 関数の pOutputBuffer パラメーターとして生成されます。

OutBufferSize は、バッファーのサイズを指定します。

[out] BytesReturned

pOutputBuffer が指すバッファーでディスプレイミニポートドライバーが返したバイト数である ULONG 型の値を保持するバッファーへのポインターとしてオペレーティングシステムによって提供されます。

戻り値

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

注釈

オペレーティングシステムは、 DxgkDdiMiracastIoControl の呼び出しが、ユーザーモードの MiracastIoControl 要求が呼び出されるのと同じプロセス空間で行われることを保証します。

オペレーティングシステムは、MiracastIoControl の各パラメーターから入力バッファーサイズと出力バッファーサイズの値をコピーするだけですが、ディスプレイミニポートドライバーはバッファーを使用する前にバッファーサイズを確認します。また、ドライバーは、 ProbeForRead 関数または ProbeForWrite 関数を使用して、呼び出しブロックを除く try/except 内でプローブ操作を実行して、入力バッファーが指すユーザーモードメモリを確認する必要があります。

この I/O 制御操作は、ユーザーモードの MiracastIoControl 関数の呼び出しで同期的に処理されます。

同期

オペレーティングシステムは、DxgkDdiMiracastCreateContext、 DxgkDdiMiracastDestroyContext、 および DxgkDdiMiracastIoControl 関数を Miracast クラスとしてグループ化します。

この関数のスレッドと同期レベルは、MiracastIoControl 関数の呼び出しでユーザーモードドライバーが HardwareAccess パラメーターを設定する方法によって設定されます。

HardwareAccess が FALSE の場合、オペレーティングシステムは DxgkDdiMiracastIoControl がスレッド処理と同期の第 2 レベルで定義されている第 2 レベルの同期モードに従っていることを保証します。 DxgkDdiMiracastIoControl は、レベル 2 関数の他のレベル 0、1、または Miracast 以外のクラスが別のスレッドコンテキストで呼び出されている場合に呼び出すことができます。ただし、一度に呼び出すことができるレベル 2 の Miracast クラス関数は 1 つだけです。
HardwareAccess が TRUE の場合、DxgkDdiMiracastIoControl は、スレッド処理と同期の第 3 レベルで定義されている第 3 レベルの同期モードに従います。 GPU のフラッシュにより、処理オーバーヘッドが大幅に増加することに注意してください。

要件

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