Fungsi VideoPortSynchronizeExecution (video.h)

Artikel
08/08/2023

Fungsi VideoPortSynchronizeExecution menyinkronkan eksekusi fungsi HwVidInterrupt yang disediakan driver miniport, jika ada. Jika tidak, ia menjalankan HwVidSynchronizeExecutionCallback pada prioritas yang dinaikkan.

Sintaks

VIDEOPORT_DEPRECATED BOOLEAN VIDEOPORT_API VideoPortSynchronizeExecution(
  PVOID                         HwDeviceExtension,
  VIDEO_SYNCHRONIZE_PRIORITY    Priority,
  PMINIPORT_SYNCHRONIZE_ROUTINE SynchronizeRoutine,
  PVOID                         Context
);

Parameter

HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

Priority

Menentukan jenis prioritas di mana SynchronizeRoutine yang diberikan harus dijalankan, sebagai salah satu dari berikut ini:

Jika Prioritas diatur ke VpLowPriority, utas saat ini dinaikkan ke prioritas noninterrupt-masking tertinggi. Dengan demikian, utas saat ini hanya dapat didahulukan oleh ISR jika perangkat terganggu.
Jika Prioritas diatur ke VpMediumPriority dan driver miniport memiliki ISR yang terkait dengan adaptor videonya, panggilan ke SynchronizeRoutine yang diberikan disinkronkan dengan fungsi HwVidInterrupt driver miniport. Jika tidak, sinkronisasi dilakukan pada tingkat VpLowPriority .
VpHighPriority memiliki efek yang sama dengan VpMediumPriority.

SynchronizeRoutine

Arahkan ke fungsi HwVidSynchronizeExecutionCallback driver miniport.

Context

Arahkan ke konteks yang disediakan pemanggil untuk diteruskan ke fungsi HwVidSynchronizeExecutionCallback driver miniport. Penunjuk ini bisa NULL.

Nilai kembali

Jika operasi berhasil, VideoPortSynchronizeExecution mengembalikan TRUE.

Keterangan

Driver miniport jarang memanggil rutinitas ini kecuali salah satu kondisi berikut menangguhkan:

Fungsi HwVidInterrupt driver miniport berbagi memori dengan fungsi driver miniport lainnya. Untuk mengakses memori bersama dengan cara yang aman multiprosesor, fungsi driver miniport tersebut harus memanggil VideoPortSynchronizeExecution dengan HwVidSynchronizeExecutionCallback. Fungsi driver miniport ini dapat mengakses memori bersama dengan aman karena driver port video mencegah fungsi HwVidInterrupt mengakses memori yang sama secara bersamaan.
Adaptor harus diprogram dengan urutan perintah tanpa tunduk pada sakelar konteks. Misalnya, fungsi SvgaHwIoPortXxx driver miniport yang telah menyangga urutan instruksi I/O dan memvalidasi urutannya mungkin memanggil VideoPortSynchronizeExecution dengan HwVidSynchronizeExecutionCallback. Fungsi driver miniport ini dapat mentransfer aliran I/O yang di-buffer dan divalidasi ke adaptor dengan sangat cepat.

Penelepon harus menentukan nilai Prioritas praktis terendah untuk pekerjaan yang harus dilakukan HwVidSynchronizeExecutionCallback . CallbackRoutine apa pun yang dijalankan pada prioritas perangkat keras tinggi (VpMediumPriority atau VpHighPriority) harus mengembalikan kontrol secepat mungkin. Driver dengan fungsi HwVidSynchronizeExecutionCallback berprioritas tinggi harus dirancang untuk melakukan pekerjaan sebanyak mungkin di setiap fungsi driver lainnya kecuali salah satu dari fungsi HwVidSynchronizeExecutionCallback dan HwVidInterrupt .

Pemanggil VideoPortSynchronizeExecution harus berjalan di IRQL

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	video.h (sertakan Video.h)
Pustaka	Videoprt.lib
DLL	Videoprt.sys
IRQL	<= DIRQL

Lihat juga

HwVidInterrupt

HwVidSynchronizeExecutionCallback

Bagikan melalui