View source for DevHelp GetDeviceBlock

{{DISPLAYTITLE: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.

==Syntax==
===C===
 DevHelp_GetDeviceBlock (USHORT Lid, PPVOID DeviceBlockPtr)

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

CALL  [Device_Help]
</PRE>
==Parameters==
===C===
; Lid (USHORT) - input : Logical ID
; DeviceBlockPtr (PPVOID) - input : Address to ABIOS device block pointer.

===Assembler===
<PRE>
MOV   AX,LogicalID
MOV   DS,Data_Segment         ; Data segment of the requesting device driver
</PRE>

==Return Code==
===C===
;Success indicator: 0
;Possible errors:
  ERROR_LID_DOES_NOT_EXIST    (0X02)
  ERROR_ABIOS_NOT_PRESENT     (0x03)
  ERROR_NOT_YOUR_LID          (0X04)

===Assembler===
<PRE>
   '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.
</PRE>

==Remarks==
None.

==Example Code==
===C===
<PRE>
#include  "dhcalls.h"

USHORT APIENTRY DevHelp_GetDeviceBlock (USHORT Lid, PPVOID DeviceBlockPtr)
</PRE>

[[Category:DevHlps]]