PFN_START_MIRACAST_SESSION fungsi panggilan balik (netdispumdddi.h)

Artikel
08/07/2023

Dipanggil oleh sistem operasi untuk memulai sesi yang terhubung dengan Miracast.

Sintaks

PFN_START_MIRACAST_SESSION PfnStartMiracastSession;

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

Parameter

[in] pMiracastContext

Penunjuk ke konteks yang terkait dengan adaptor tampilan.

Sistem operasi memperoleh konteks ketika disebut fungsi CreateMiracastContext driver mode pengguna Miracast.

[in] MiracastRTSPSocket

Handel soket jaringan yang disediakan sistem operasi dari Real Time Streaming Protocol (RTSP).

Catatan Driver mode pengguna Miracast tidak boleh menutup soket ini. Ketika fungsi StopMiracastSession dipanggil, sistem operasi akan menutup soket ini.

[in] pWfdConnectionStats

Penunjuk ke struktur MIRACAST_WFD_CONNECTION_STATS yang menunjukkan statistik koneksi Wi-Fi Direct.

[out] pSessionInfo

Penunjuk ke struktur MIRACAST_SESSION_INFO yang harus diselesaikan driver mode pengguna Miracast setelah mendapatkan kemampuan sink Miracast.

Mengembalikan nilai

Setelah berhasil, fungsi ini mengembalikan STATUS_SUCCESS. Jika tidak, fungsi mengembalikan kode kesalahan yang ditentukan di header Ntstatus.h, termasuk yang berikut:

Menampilkan kode	Deskripsi
STATUS_DEVICE_INSUFFICIENT_RESOURCES	Tingkat pengodean yang disarankan saat ini tidak dapat mempertahankan sink Miracast yang mendukung lebih dari 1024 x 768 piksel.

Keterangan

Ketika fungsi ini dipanggil, driver mode pengguna Miracast harus mulai berkomunikasi dengan sink Miracast menggunakan protokol Miracast. Driver harus mengumpulkan kemampuan sink dan atribut monitor yang terhubung ke sink. Driver harus melakukan cukup negosiasi dengan sink untuk menentukan apakah monitor terhubung ke sink atau tidak. Jika driver menentukan bahwa monitor terhubung ke sink, itu juga harus menentukan apakah laju bit yang disarankan saat ini cukup tinggi untuk setidaknya mendukung mode terendah yang didukung sink 1024 x 768 piksel.

Driver juga harus menetapkan nilai anggota MIRACAST_SESSION_INFO ini yang diarahkan oleh pSessionInfo dalam kasus ini:

Keamanan Thread

Sistem operasi menjamin bahwa hanya salah satu fungsi CreateMiracastContext, DestroyMiracastContext, StartMiracastSession, dan StopMiracastSession yang dipanggil pada satu waktu.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1
Server minimum yang didukung	Windows Server 2012 R2
Target Platform	Desktop
Header	netdispumdddi.h (sertakan Netdispumdddi.h)