IOCTL_PWM_PIN_SET_POLARITY IOCTL (pwm.h)

Статья
08/25/2023

Задает полярность сигнала контакта или канала. Код элемента управления задает полярность сигнала на основе структуры PWM_PIN_SET_POLARITY_INPUT . Полярность сигнала имеет значение "Активный высокий" или "Активный низкий", как определено в перечислении PWM_POLARITY .

Входной буфер

Указатель на буфер, содержащий структуру PWM_PIN_GET_POLARITY_OUTPUT . Представляет значение полярности контроллера PWM и имеет значение "Активный высокий" или "Активный низкий".

Длина входного буфера

Размер входного буфера в байтах.

Выходной буфер

Не используется с этой операцией; задайте значение NULL.

Длина выходного буфера

Не используется с этой операцией; Значение равно нулю.

BOOL 
   WINAPI 
   DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                    (DWORD)        IOCTL_PWM_PIN_SET_POLARITY, // dwIoControlCode(LPDWORD)      lpInBuffer,      // input buffer
                    (DWORD)        nInBufferSize,   // size of input buffer
                    (LPDWORD)      NULL,      // output buffer
                    (DWORD)        0,  // size of output buffer
                    (LPDWORD)      lpBytesReturned, // number of bytes returned
                    (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Параметры	Описание
hDevice [in]	Дескриптор устройства. Чтобы получить дескриптор устройства, вызовите функцию CreateFile .
dwIoControlCode [in]	Код элемента управления для операции. Для этой операции используйте IOCTL_PWM_PIN_SET_POLARITY .
lpInBuffer	Указатель на буфер, содержащий структуру PWM_PIN_GET_POLARITY_OUTPUT . Представляет значение полярности контроллера PWM и имеет значение "Активный высокий" или "Активный низкий".
nInBufferSize [in]	Размер входного буфера в байтах.
lpOutBuffer [out]	Не используется с этой операцией; задайте значение NULL.
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 возвращает немедленно, а объект события получает сигнал о завершении операции. В противном случае функция не возвращается, пока операция не будет завершена или не возникнет ошибка.

Изменение полярности допускается только в том случае, если закрепление остановлено. Вы можете определить, остановлен ли закрепление, с помощью кода элемента управления IOCTL_PWM_PIN_IS_STARTED .

Изменение полярности при запуске булавки может привести к сбоям на некоторых контроллерах импульсной ширины (PWM). Если вы хотите изменить полярность, сначала остановите контакт, измените полярность, а затем запустите контакт.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Верхняя часть	pwm.h (включая Pwm.h)

См. также раздел

DeviceIoControl

Поделиться через