IOCTL_HAL_INIT_RTC
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este IOCTL redefine o relógio em tempo real por chamado de OEMSetRealTime função. Uma solicitação para chamar OEMSetRealTime é feita pelo chamado OEMIoControl função com IOCTL_HAL_INIT_RTC.
Parâmetros
dwIoControlCode
[no] Defina como IOCTL_HAL_INIT_RTC.Redefine o relógio em tempo real por chamado OEMSetRealTime.
- lpInBuf
[no] Ponteiro para o buffer de entrada que contém um SYSTEMTIME estrutura.
nInBufsize
[no] Tamanho, em bytes, de lpInBuf.Isso deve ser o tamanho das SYSTEMTIME estrutura.
- lpOutBuf
[no] Não usado; Definir como NULL.
- nOutBufSize
[no] Não usado; definido como zero.
- lpBytesReturned
[no] Não usado; pode ser configurada para NULL.
Valores Return
TRUE indica sucesso. FALSE indica falha.
Remarks
Durante uma inicializar Frieza, o kernel chama esse IOCTL. Sistemas com um relógio em tempo real Battery-backed podem então determinar se o atual tempo relógio é válido e em caso afirmativo, ignorar o tempo fornecido pelo kernel. Caso contrário, definir o relógio em tempo real para coincidir com o tempo fornecido. Sistemas sem um relógio Battery-backed devem usar o tempo padrão fornecido pelo kernel para inicializar seu relógio em tempo real como parte da seqüência a frio inicializar.
Para dispositivos que não possuem externo a energia para o relógio em tempo real, chamadas Filesys.exe IOCTL_HAL_INIT_RTC quando o sistema é inicializado backup se o de conteúdo memória RAM inválido. Geralmente, é a inicializar limpa memória RAM devido a batter de energia sendo fora ou se a armazenamento persistente foi desmarcada. Para dispositivos sem externo energia para o relógio em tempo real, os OEMs precise redefinir seu relógio em tempo real se IOCTL_HAL_INIT_RTC foi chamado. No entanto, esse cenário é diferente durante um processo atualização:
- Quando o sistema é inicializado para a imagem Update Loader, ela será sempre um inicializar limpa memória RAM da perspectiva Update Loader, mas o relógio em tempo real não deve ser redefinir. Portanto, a OAL do carregador de atualização não deve redefinir o relógio em tempo real quando IOCTL_HAL_INIT_RTC for chamado, mas somente retorno TRUE e não fazer nada.
- Quando a conclusão processo atualização e o sistema for reinicializado voltar para o primário OS, o carregador de atualização destrói o de conteúdo memória RAM por isso, é um memória RAM limpa inicializar a partir de primário perspectiva OS. Neste maiúsculas e minúsculas, os OEMs não devem redefinir o relógio em tempo real qualquer. O primário kernel OS deve ser notificado que o reiniciar foi emitido pelo carregador de atualização e, em seguida, ignorar a solicitação para IOCTL_HAL_INIT_RTC. Isso é feito através de OAL para que os OEMs precise localizar uma maneira para detecção este maiúsculas e minúsculas.
Requisitos
| Header | pkfuncs.h |
| Windows Embedded CE | Windows CE 3.0 and later |