次の方法で共有


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

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これらのメンバーの値も設定する必要があります。

スレッド セーフ

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

要件

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

こちらもご覧ください

CreateMiracastContext

DestroyMiracastContext

MIRACAST_SESSION_INFO

MIRACAST_WFD_CONNECTION_STATS

StopMiracastSession