Share via

IOCTL_HAL_AUTHENTICATE_DEVICE (Compact 2013)

  • Article

10/16/2014

This I/O control message is predefined for an OEM who wants to authenticate the device before the device is allowed to boot and be used by a user. Send this message with OEMIoControl.

Syntax

BOOL OEMIoControl(
    DWORD dwIoControlCode,    // use IOCTL_HAL_AUTHENTICATE_DEVICE
    LPVOID lpInBuffer,        // pointer to input buffer
    DWORD nInBufferSize,      // input buffer size
    LPVOID lpOutBuffer,       // pointer to output buffer
    DWORD nOutBufferSize,     // output buffer size
    LPDWORD lpBytesReturned   // number of bytes returned
);

Parameters

  • dwIoControlCode
    [in] Control code for the operation. Use IOCTL_HAL_AUTHENTICATE_DEVICE for this operation.

Remarks

The parameters are implemented by the OEM, and the return values are based on the OEM implementation. The data passed to the OAL is OEM-specific and depends on how the OEM wants to validate the run-time image running on the device.

An image can be encoded with a device's hardware ID so the image only runs on one device. When the device boots, an application can be run that will call this I/O control and pass information to the OAL so a comparison of values can be achieved.

Requirements

Header

pkfuncs.h

See Also

Reference

Security IOCTLs