KernelIoControl (Windows CE 5.0)

Send Feedback

This function provides the kernel with a generic I/O control for carrying out I/O operations.

BOOLKernelIoControl( DWORD dwIoControlCode,LPVOID lpInBuf,DWORD nInBufSize,LPVOID lpOutBuf,DWORD nOutBufSize,LPDWORD lpBytesReturned );

Parameters

  • dwIoControlCode
    [in] I/O control code, which should support the OAL I/O controls. For a list of these I/O controls, see OAL IOCTLs.

  • lpInBuf
    [out] Pointer to a buffer that contains the data required to perform the operation.

    Set to NULL if the dwIoControlCode parameter specifies an operation that does not require input data.

  • nInBufSize
    [in] Size, in bytes, of the buffer pointed to by lpInBuf.

  • lpOutBuf
    [out] Pointer to a buffer that receives the output data for the operation.

    Set to NULL if the dwIoControlCode parameter specifies an operation that does not produce output data.

  • nOutBufSize
    [in] Size, in bytes, of the buffer pointed to by lpOutBuf.

  • lpBytesReturned
    [in] Long pointer to a variable that receives the size, in bytes, of the data stored in the buffer pointed to by lpOutBuf. Even when an operation produces no output data, and lpOutBuf is NULL, the KernelIoControl function uses the variable pointed to by lpBytesReturned. After such an operation, the value of the variable has no meaning.

Return Values

TRUE indicates success; FALSE indicates failure.

Remarks

The kernel calls the OEMIoControl function when a device driver or application calls the kernel function KernelIoControl and passes an I/O control code.

This function is also called when the SystemParametersInfo function is called with SPI_GETOEMINFO or SPI_GETPLATFORMINFO.

The system is fully preemptible when this function is called. The kernel does no processing, but it passes all parameters directly to the function supplied by you.

This function is provided solely to allow your device driver or application to communicate with an OAL and its specific functionality.

Requirements

OS Versions: Windows CE 2.10 and later.
Header: Pkfuncs.h.
Link Library: Coredll.lib.

See Also

OEMIoControl | OEMKDIoControl | SystemParametersInfo

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.