Compartir a través de

IOCTL_PWM_CONTROLLER_GET_INFO IOCTL (pwm.h)

  • Artículo

Recupera información sobre un controlador de modulación de ancho de pulso (PWM). Esta información no cambia después de inicializar el controlador.

Búfer de entrada

No se usa con esta operación; se establece en NULL.

Longitud del búfer de entrada

No se usa con esta operación; se establece en cero.

Búfer de salida

Puntero a un búfer que contiene una estructura de PWM_CONTROLLER_INFO . Representa la información estática que caracteriza un controlador de modulación de ancho de pulso (PWM).

Longitud del búfer de salida

El tamaño del búfer de salida debe ser exactamente igual al tamaño de la estructura solicitada PWM_CONTROLLER_INFO . Cada versión más reciente PWM_CONTROLLER_INFO tiene un tamaño de byte mayor que el de la versión anterior.

Comentarios

Para realizar esta operación, llame a la función DeviceIoControl con los siguientes parámetros.

BOOL 
   WINAPI 
   DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                    (DWORD)        IOCTL_PWM_CONTROLLER_GET_INFO, // 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
Parámetros Descripción
hDevice [in] Identificador del dispositivo. Para obtener un identificador de dispositivo, llame a la función CreateFile .
dwIoControlCode [in] Código de control de la operación. Use IOCTL_PWM_CONTROLLER_GET_ACTUAL_PERIOD para esta operación.
lpInBuffer No se usa con esta operación; se establece en NULL.
nInBufferSize [in] No se usa con esta operación; se establece en cero.
lpOutBuffer [out] Puntero a un búfer que contiene una estructura de PWM_CONTROLLER_INFO . Representa la información estática que caracteriza un controlador de modulación de ancho de pulso (PWM).
nOutBufferSize [in] El tamaño del búfer de salida debe ser exactamente igual al tamaño de la estructura solicitada PWM_CONTROLLER_INFO . Cada versión más reciente PWM_CONTROLLER_INFO tiene un tamaño de byte mayor que el de la versión anterior.
lpBytesReturned [out] Puntero a una variable que recibe el tamaño de los datos almacenados en el búfer de salida, en bytes.

Si el búfer de salida es demasiado pequeño, se produce un error en la llamada, GetLastError devuelve ERROR_INSUFFICIENT_BUFFER y lpBytesReturned es cero.

Si lpOverlapped es NULL, lpBytesReturned no puede ser NULL. Incluso cuando una operación no devuelve datos de salida y lpOutBuffer es NULL, DeviceIoControl usa lpBytesReturned. Después de esta operación, el valor de lpBytesReturned no tiene sentido.

Si lpOverlapped no es NULL, lpBytesReturned puede ser NULL. Si este parámetro no es NULL y la operación devuelve datos, lpBytesReturned no tiene sentido hasta que se haya completado la operación superpuesta. Para recuperar el número de bytes devueltos, llame a GetOverlappedResult. Si el parámetro hDevice está asociado a un puerto de finalización de E/S, puede recuperar el número de bytes devueltos llamando a GetQueuedCompletionStatus.
lpOverlapped [in] Puntero a una estructura OVERLAPPED.

Si hDevice se abrió sin especificar FILE_FLAG_OVERLAPPED, se omite lpOverlapped.

Si hDevice se abrió con la marca FILE_FLAG_OVERLAPPED, la operación se realiza como una operación superpuesta (asincrónica). En este caso, lpOverlapped debe apuntar a una estructura SUPERPUESTA válida que contenga un identificador para un objeto de evento. De lo contrario, se producirá un error en la función de formas impredecibles.

En el caso de las operaciones superpuestas, se devuelve inmediatamente DeviceIoControl y se señala el objeto de evento cuando se ha completado la operación. De lo contrario, la función no se devuelve hasta que se haya completado la operación o hasta que se produzca un error.
 

Si el tamaño del búfer es menor que el tamaño de la versión de estructura más baja, la solicitud se completa mediante un estado de finalización de IOCTL de STATUS_BUFFER_TOO_SMALL. De lo contrario, el controlador asume la versión de estructura más alta que puede caber en el búfer de salida proporcionado y completa correctamente la solicitud.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Encabezado pwm.h (include Pwm.h)

Consulte también

DeviceIoControl