Skip to content

WindowsApi:KernelIoControl

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

일반적인 IO컨트롤을 위한 정보를 커널에 요청한다.

Syntax 

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

Requirements

OS Versions

Windows CE 2.10 and later

Header

Pkfuncs.h

Link Library

Coredll.lib

Windows CE UUID Example

Windows CE 에서 UUID를 취득하는 방법에 대하여 설명한다.

For the Windows Thin Client to read the UUID from where it is saved in nonvolatile memory, you must call GetUUID(). %_WINCEROOT%\Public\Rdp\Oak\Uit\Wbttscmn\Ioctl.cpp contains the GetUUID() function. GetUUID in turn calls KernelIoControl for the IOCTL_HAL_GET_UUID.

Then, to handle the call to that function, you must implement the section of code in the OEM Adaptation Layer (OAL) for the CEPC OS design. An example of the recommended implementation for any Windows Thin Client device that uses the Remote Desktop (RDP) client can be found at %_WINCEROOT%\OS design\Cepc\Kernel\Hal\Oemoictl.c

The following procedures show how to make the Windows Thin Client read the UUID and then implement the OAL code for the CEPC OS design.

To read a UUID

Implement KernelIoControl. The control code that is specified for reading a UUID is IOCTL_HAL_GET_UUID. The following code example shows how to make the Windows Thin Client read a UUID. 

BOOL GetUUID () 
{
  GUID myUUID;
  BOOL bRetVal;
  DWORD dwBytesReturned;

  bRetVal = KernelIoControl (IOCTL_HAL_GET_UUID, NULL, 0, &myUUID, 
                             sizeof (myUUID), &dwBytesReturned);
  if (!bRetVal) 
  {
    RETAILMSG(1, TEXT("KernelIoControl call failed!\r\n"));
    return FALSE;
  }

  RETAILMSG(
    1,
    TEXT("UUID: %08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X\r\n"),
    myUUID.Data1,
    myUUID.Data2,
    myUUID.Data3,
    myUUID.Data4[0],
    myUUID.Data4[1],
    myUUID.Data4[2],
    myUUID.Data4[3],
    myUUID.Data4[4],
    myUUID.Data4[5],
    myUUID.Data4[6],
    myUUID.Data4[7]);

  return TRUE;
}

See also

Favorite site