PFN_HANDLE_KMD_MESSAGE コールバック関数 (netdispumdddi.h)

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

ディスプレイミニポートドライバーが DxgkCbMiracastSendMessage 関数を呼び出したときに Miracast ユーザーモードドライバーが受信する非同期カーネルモードメッセージを処理するために、オペレーティングシステムによって呼び出されます。

構文

PFN_HANDLE_KMD_MESSAGE PfnHandleKmdMessage;

NTSTATUS PfnHandleKmdMessage(
  [in]  PVOID pMiracastContext,
  [in]  UINT InputBufferSize,
  [in]  VOID *pInputBuffer,
  [in]  UINT OutputBufferSize,
  [out] VOID *pOutputBuffer,
  [out] UINT *pBytesReturned
)
{...}

パラメーター

[in] pMiracastContext

ディスプレイアダプターに関連付けられているコンテキストへのポインター。

オペレーティングシステムは、Miracast ユーザーモードドライバーの CreateMiracastContext 関数を呼び出したときにコンテキストを取得しました。

[in] InputBufferSize

オペレーティングシステムによって提供される入力バッファー pInputBuffer のサイズ。

[in] pInputBuffer

オペレーティングシステムによって提供される入力バッファーへのポインター。

[in] OutputBufferSize

オペレーティングシステムによって提供される出力バッファー pOutputBuffer のサイズ。

[out] pOutputBuffer

オペレーティングシステムによって提供される出力バッファーへのポインター。

[out] pBytesReturned

ディスプレイミニポートドライバーが pOutputBuffer で書き込んだ返されたバイト数を保持する、オペレーティングシステムによって提供されるバッファーへのポインター。

戻り値

成功すると、この関数は STATUS_SUCCESSを返します。それ以外の場合、関数は Ntstatus.h ヘッダーで定義されたエラーコードを返します。

注釈

スレッドセーフ

この関数が呼び出されると、別のスレッドでも呼び出されている可能性があります。そのため、ドライバーは、必要に応じて HandleKernelModeMessage への複数の呼び出しを同期する役割を担います。

オペレーティングシステムでは、CreateMiracastContext、DestroyMiracastContext、StartMiracastSession、StopMiracastSession が呼び出されたときに、この関数が呼び出されないことが保証されます。 Miracast 接続セッション (StartMiracastSession) の起動時にディスプレイミニポートドライバーが送信するすべてのメッセージは、セッションの起動プロセスが完了するまでブロックされます。オペレーティングシステムは、Miracast セッションを停止する呼び出しの間または呼び出し後にディスプレイミニポートドライバーが送信するすべてのメッセージもブロックします (StopMiracastSession)。

要件

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