IOCTL_PWM_CONTROLLER_GET_ACTUAL_PERIOD IOCTL (pwm.h)
Mengambil periode sinyal output efektif pengontrol Pulse Width Modulation (PWM) seperti yang akan diukur pada saluran outputnya.
Buffer input
Tidak digunakan dengan operasi ini; atur ke NULL.
Panjang buffer input
Tidak digunakan dengan operasi ini; atur ke nol.
Buffer output
Penunjuk ke buffer yang berisi nilai PWM_CONTROLLER_GET_ACTUAL_PERIOD_OUTPUT . Ini mewakili periode sinyal output efektif pengontrol Pulse Width Modulation (PWM) seperti yang akan diukur pada saluran outputnya.
Panjang buffer output
Ukuran buffer output, dalam byte.
Keterangan
Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to device (DWORD) IOCTL_PWM_CONTROLLER_GET_ACTUAL_PERIOD, // dwIoControlCode(LPDWORD) NULL, // input buffer (DWORD) 0, // size of input buffer (LPDWORD) lpOutBuffer, // output buffer (DWORD) nOutBufferSize, // size of output buffer (LPDWORD) lpBytesReturned, // number of bytes returned (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure
Parameter | Deskripsi |
---|---|
hDevice [in] | Handel ke perangkat. Untuk mendapatkan handel perangkat, panggil fungsi CreateFile . |
dwIoControlCode [in] | Kode kontrol untuk operasi. Gunakan IOCTL_PWM_CONTROLLER_GET_ACTUAL_PERIOD untuk operasi ini. |
lpInBuffer | Tidak digunakan dengan operasi ini; atur ke NULL. |
nInBufferSize [in] | Tidak digunakan dengan operasi ini; atur ke nol. |
lpOutBuffer [out] | Penunjuk ke buffer yang berisi nilai PWM_CONTROLLER_GET_ACTUAL_PERIOD_OUTPUT . Ini mewakili periode sinyal output efektif pengontrol Pulse Width Modulation (PWM) seperti yang akan diukur pada saluran outputnya. |
nOutBufferSize [in] | Ukuran buffer output, dalam byte. |
lpBytesReturned [out] |
LPDWORD
Penunjuk ke variabel yang menerima ukuran data yang disimpan dalam buffer output, dalam byte. Jika buffer output terlalu kecil, panggilan gagal, GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER, dan lpBytesReturned adalah nol. Jika lpOverlapped adalah NULL, lpBytesReturned tidak boleh NULL. Bahkan ketika operasi tidak mengembalikan data output dan lpOutBuffer adalah NULL, DeviceIoControl menggunakan lpBytesReturned. Setelah operasi seperti itu, nilai lpBytesReturned tidak ada artinya. Jika lpOverlapped bukan NULL, lpBytesReturned dapat berupa NULL. Jika parameter ini bukan NULL dan operasi mengembalikan data, lpBytesReturned tidak berarti sampai operasi yang tumpang tindih telah selesai. Untuk mengambil jumlah byte yang dikembalikan, panggil GetOverlappedResult. Jika parameter hDevice dikaitkan dengan port penyelesaian I/O, Anda dapat mengambil jumlah byte yang dikembalikan dengan memanggil GetQueuedCompletionStatus. |
lpOverlapped [in] |
LPOVERLAPPED
Penunjuk ke struktur yang TUMPANG TINDIH . Jika hDevice dibuka tanpa menentukan FILE_FLAG_OVERLAPPED, lpOverlapped diabaikan. Jika hDevice dibuka dengan bendera FILE_FLAG_OVERLAPPED , operasi dilakukan sebagai operasi yang tumpang tindih (asinkron). Dalam hal ini, lpOverlapped harus menunjuk ke struktur TUMPANG TINDIH yang valid yang berisi handel ke objek peristiwa. Jika tidak, fungsi gagal dengan cara yang tidak dapat diprediksi. Untuk operasi yang tumpang tindih, DeviceIoControl segera kembali, dan objek peristiwa diberi sinyal ketika operasi telah selesai. Jika tidak, fungsi tidak kembali sampai operasi selesai atau terjadi kesalahan. |
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 10 [khusus aplikasi desktop] |
Server minimum yang didukung | Windows Server 2016 [hanya aplikasi desktop] |
Header | pwm.h (sertakan Pwm.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk