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

[アーティクル]
03/05/2024

Miracast 接続セッションを開始するためにオペレーティングシステムによって呼び出されます。

構文

PFN_START_MIRACAST_SESSION PfnStartMiracastSession;

NTSTATUS PfnStartMiracastSession(
  [in]  PVOID pMiracastContext,
  [in]  SOCKET MiracastRTSPSocket,
  [in]  MIRACAST_WFD_CONNECTION_STATS *pWfdConnectionStats,
  [out] MIRACAST_SESSION_INFO *pSessionInfo
)
{...}

パラメーター

[in] pMiracastContext

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

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

[in] MiracastRTSPSocket

リアルタイムストリーミングプロトコル (RTSP) のオペレーティングシステム提供のネットワークソケットハンドル。

メモ Miracast ユーザーモードドライバーは、このソケットを閉じてはいけません。 StopMiracastSession 関数が呼び出されると、オペレーティングシステムはこのソケットを閉じます。

[in] pWfdConnectionStats

Wi-Fi 直接接続の統計情報を示すMIRACAST_WFD_CONNECTION_STATS構造体へのポインター。

[out] pSessionInfo

Miracast ユーザーモードドライバーが Miracast シンクの機能を取得した後に完了する必要がある MIRACAST_SESSION_INFO構造体へのポインター。

戻り値

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

リターンコード	説明
STATUS_DEVICE_INSUFFICIENT_RESOURCES	現在推奨されているエンコードレートは、1024 x 768 ピクセルを超える Miracast シンクを維持できません。

注釈

この関数が呼び出されると、Miracast ユーザーモードドライバーは Miracast プロトコルを使用して Miracast シンクとの通信を開始する必要があります。ドライバーは、シンクの機能と、シンクに接続されているモニターの属性を収集する必要があります。ドライバーは、モニターがシンクに接続されているかどうかを判断するために、シンクとのネゴシエーションを十分に実行する必要があります。モニターがシンクに接続されていることをドライバーが判断した場合は、少なくとも 1024 x 768 ピクセルの最小シンクサポートモードをサポートするのに十分な現在の推奨ビットレートが十分に高いかどうかを判断する必要があります。

ドライバーは、次の場合に pSessionInfo によって指MIRACAST_SESSION_INFOこれらのメンバーの値も設定する必要があります。

スレッドセーフ

オペレーティングシステムでは、 CreateMiracastContext、 DestroyMiracastContext、 StartMiracastSession、および StopMiracastSession 関数の 1 つだけが一度に呼び出されることを保証します。

要件

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