IOCTL_PWM_CONTROLLER_GET_ACTUAL_PERIOD IOCTL (pwm.h)
Извлекает период эффективного выходного сигнала контроллера широтной модуляции (PWM) в том виде, в который он будет измеряться в его выходных каналах.
Входной буфер
Не используется с этой операцией; для параметра задано значение NULL.
Длина входного буфера
Не используется с этой операцией; Значение равно нулю.
Выходной буфер
Указатель на буфер, содержащий значение PWM_CONTROLLER_GET_ACTUAL_PERIOD_OUTPUT . Он представляет период эффективного выходного сигнала контроллера ШИМ, который будет измеряться по его выходным каналам.
Длина выходного буфера
Размер выходного буфера в байтах.
Комментарии
Для выполнения этой операции вызовите функцию DeviceIoControl со следующими параметрами.
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
Параметры | Описание |
---|---|
hDevice [in] | Дескриптор устройства. Чтобы получить дескриптор устройства, вызовите функцию CreateFile . |
dwIoControlCode [in] | Код элемента управления для операции. Используйте IOCTL_PWM_CONTROLLER_GET_ACTUAL_PERIOD для этой операции. |
lpInBuffer | Не используется с этой операцией; для параметра задано значение NULL. |
nInBufferSize [in] | Не используется с этой операцией; Значение равно нулю. |
lpOutBuffer [out] | Указатель на буфер, содержащий значение PWM_CONTROLLER_GET_ACTUAL_PERIOD_OUTPUT . Он представляет период эффективного выходного сигнала контроллера ШИМ, который будет измеряться по его выходным каналам. |
nOutBufferSize [in] | Размер выходного буфера в байтах. |
lpBytesReturned [out] |
LPDWORD
Указатель на переменную, которая получает размер данных, хранящихся в выходном буфере, в байтах. Если выходной буфер слишком мал, вызов завершается ошибкой, GetLastError возвращает ERROR_INSUFFICIENT_BUFFER, а значение lpBytesReturned равно нулю. Если lpOverlapped имеет значение NULL, lpBytesReturned не может иметь значение NULL. Даже если операция не возвращает выходные данные и lpOutBuffer имеет значение NULL, DeviceIoControl использует lpBytesReturned. После такой операции значение lpBytesReturned не имеет смысла. Если значение lpOverlapped не равно NULL, lpBytesReturned может иметь значение NULL. Если этот параметр не равен NULL и операция возвращает данные, функция lpBytesReturned не имеет смысла до завершения перекрывающейся операции. Чтобы получить количество возвращенных байтов, вызовите Метод GetOverlappedResult. Если параметр hDevice связан с портом завершения ввода-вывода, можно получить количество возвращаемых байтов, вызвав Метод GetQueuedCompletionStatus. |
lpOverlapped [in] |
LPOVERLAPPED
Указатель на структуру OVERLAPPED . Если hDevice был открыт без указания FILE_FLAG_OVERLAPPED, lpOverlapped игнорируется. Если hDevice был открыт с флагом FILE_FLAG_OVERLAPPED , операция выполняется как перекрываемая (асинхронная) операция. В этом случае lpOverlapped должен указывать на допустимую структуру OVERLAPPED , содержащую дескриптор объекта события. В противном случае функция завершается сбоем непредсказуемым образом. Для перекрывающихся операций DeviceIoControl возвращает немедленно, и объект события получает сигнал о завершении операции. В противном случае функция не возвращается, пока операция не будет завершена или не возникнет ошибка. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 10 [только классические приложения] |
Минимальная версия сервера | Windows Server 2016 [только классические приложения] |
Верхняя часть | pwm.h (включая Pwm.h) |