PFN_MIRACAST_IO_CONTROL fungsi panggilan balik (netdispumdddi.h)

Artikel
08/07/2023

Dipanggil oleh driver tampilan mode pengguna untuk mengirim driver miniport tampilan mode kernel permintaan kontrol I/O sinkron. Jenis data fungsi ini PFN_MIRACAST_IO_CONTROL.

Sintaks

PFN_MIRACAST_IO_CONTROL PfnMiracastIoControl;

NTSTATUS PfnMiracastIoControl(
  [in]            HANDLE hMiracastDeviceHandle,
  [in]            BOOL HardwareAccess,
  [in]            UINT InputBufferSize,
  [in]            VOID *pInputBuffer,
  [in]            UINT OutputBufferSize,
  [out]           VOID *pOutputBuffer,
  [out, optional] UINT *pBytesReturned
)
{...}

Parameter

[in] hMiracastDeviceHandle

Handel yang mewakili perangkat Miracast. Driver mode pengguna Miracast sebelumnya mendapatkan handel ini sebagai parameter hMiracastDeviceHandle dalam panggilan ke fungsi CreateMiracastContext .

[in] HardwareAccess

Nilai Boolean yang menunjukkan apakah permintaan kontrol I/O ini dari driver tampilan mode pengguna perlu menghapus semua buffer GPU DMA yang tertunda.

Kami tidak menyarankan agar driver menetapkan nilai ini ke TRUE kecuali jika perlu, karena membersihkan GPU akan membuat overhead pemrosesan yang substansial.

[in] InputBufferSize

Ukuran, dalam byte, dari buffer input yang diacu oleh pInputBuffer.

[in] pInputBuffer

Penunjuk ke buffer input. Parameter InputBufferSize menentukan ukuran buffer.

[in] OutputBufferSize

Ukuran, dalam byte, dari buffer output yang diacu oleh pOutputBuffer.

[out] pOutputBuffer

Penunjuk yang disediakan driver ke buffer output. Parameter OutputBufferSize menentukan ukuran buffer.

[out, optional] pBytesReturned

Penunjuk opsional yang disediakan driver ke variabel jenis UINT yang menyimpan jumlah byte yang dikembalikan driver miniport tampilan.

Mengembalikan nilai

Setelah berhasil, sistem operasi mengembalikan STATUS_SUCCESS. Jika tidak, fungsi mengembalikan kode kesalahan yang ditentukan dalam header Ntstatus.h.

Keterangan

Jika driver mode pengguna Miracast memanggil MiracastIoControl ketika sistem operasi memulai sesi Miracast, dan jika utas panggilan bukan utas di mana sistem operasi memanggil fungsi StartMiracastSession , sistem operasi memblokir panggilan MiracastIoControl sampai sesi mulai Miracast selesai. Jika driver mode pengguna memanggil MiracastIoControl dalam konteks yang sama seperti yang digunakan dalam fungsi CreateMiracastContext atau StartMiracastSession , sistem operasi akan memproses panggilan.

Jika driver mode pengguna Miracast memanggil MiracastIoControl ketika sistem operasi menghentikan sesi Miracast, dan jika utas panggilan bukan utas tempat sistem operasi memanggil fungsi StopMiracastSession , sistem operasi akan gagal dalam panggilan ini. Jika driver mode pengguna memanggil MiracastIoControl dalam konteks yang sama seperti yang digunakan dalam fungsi StopMiracastSession atau DestroyMiracastContext , sistem operasi akan memproses panggilan.

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)

Lihat juga

CreateMiracastContext

DestroyMiracastContext

StartMiracastSession

StopMiracastSession