DevHelp GetDeviceBlock

This service returns an ABIOS device block pointer. This function returns a protect-mode pointer only. Real-mode pointers are not returned; instead, the data is initialized to 0.

C
 DevHelp_GetDeviceBlock (USHORT Lid, PPVOID DeviceBlockPtr) 

Assembler
 MOV  AX,LogicalID MOV  DS,Data_Segment         ; Data segment of the requesting device driver MOV  DL,DevHlp_GetDeviceBlock

CALL [Device_Help] 

C

 * Lid (USHORT) - input : Logical ID
 * DeviceBlockPtr (PPVOID) - input : Address to ABIOS device block pointer.

Assembler
 MOV  AX,LogicalID MOV  DS,Data_Segment         ; Data segment of the requesting device driver 

C

 * Success indicator: 0

ERROR_LID_DOES_NOT_EXIST   (0X02) ERROR_ABIOS_NOT_PRESENT    (0x03) ERROR_NOT_YOUR_LID         (0X04)
 * Possible errors:

Assembler
 'C' Clear if successful. CX:DX = Protect mode device block pointer. AX:BX = 00:00 (was real mode device block pointer; returned as 00:00 for compatibility).

'C' Set if error. AX = Error code. Possible errors: ERROR_LID_DOES_NOT_EXIST   (0X02) ERROR_ABIOS_NOT_PRESENT    (0x03) ERROR_NOT_YOUR_LID         (0X04) 

Remarks
None.

C

 * 1) include "dhcalls.h"

USHORT APIENTRY DevHelp_GetDeviceBlock (USHORT Lid, PPVOID DeviceBlockPtr) 