Type a page name and press Enter. You'll jump to the page if it exists, or you can create it if it doesn't.
To create a page in a module other than kernel32, prefix the name with the module name and a period.
[DllImport("Kernel32.dll", CharSet=CharSet.Auto, SetLastError=true)]
public static extern bool DeviceIoControl( IntPtr hDevice, uint dwIoControlCode, ref long InBuffer,
int nInBufferSize, ref long OutBuffer, int nOutBufferSize,
ref int pBytesReturned, [In] ref NativeOverlapped lpOverlapped);
<DllImport("kernel32.dll", ExactSpelling:=True, SetLastError:=True, CharSet:=CharSet.Auto)> _
Private Shared Function DeviceIoControl(ByVal hDevice As IntPtr, _
ByVal dwIoControlCode As Int32, ByVal lpInBuffer As IntPtr, _
ByVal nInBufferSize As Int32, ByVal lpOutBuffer As IntPtr, _
ByVal nOutBufferSize As Int32, ByRef lpBytesReturned As Int32, _
ByVal lpOverlapped As System.Threading.NativeOverlapped) As Boolean
End Function
User-Defined Types:
None.
Notes:
hDevice - To retrieve a handle to a volume, call CreateFile with the lpFileName parameter set to a string of the following form: \\.\DriveLetter:. DriveLetter is not case-sensitive and does not require a colon after it.
lpOverlapped - Main use in asynchronous deviceIoControl. NativeOverlapped is the managed version of the structure and use is the same. The difference between NativeOverlapped and Overlapped is managed Struct vs managed Class respectively. NativeOverlapped was more condusive for one-way device driver communication. Convert from Overlapped to NativeOverlapped to make the call, since NativeOverlapped is explicitly defined to mimic the unmanaged Overlapped structure.
Tips & Tricks:
This is great for interacting with devices; now perhaps someone can help with the SetupDi calls to actually discover the device handles, etc...? If you are able to conquer it (I wasn't) toss me a mail at dotnet at richardgoodwin dot com
-
Pin your NativeOverlapped structure, DeviceIoControl is asynchronous and will write into the overlapped structure upon completion of IO requested. If you NativeOverlapped structure has been moved by garbage collection it will write into the wrong area causing heap corruption.
-
If you want x64 proccessor support, you CANNOT use the System.Threading.NativeOverlapped structure as a ref parameter described above. The overlap structure must be allocated in global memory space. See the section "DeviceIoControl w/x64 support":
Regards,
Travis
-
Sample Code:
Public ReadOnly Property CardID() As String
Get
Dim dwErrorCode As FarcConstants
Dim dwBytesReceived As Int32
Dim ip As IntPtr = Marshal.AllocHGlobal(13)
Dim erg As String
If DeviceIoControl(hDriver, IOCTL_FARC_GET_CARDID, Nothing, 0, ip, 13, dwBytesReceived, Nothing) Then
erg = Marshal.PtrToStringAnsi(ip)
Marshal.FreeHGlobal(ip)
Else
dwErrorCode = Marshal.GetLastWin32Error
Marshal.FreeHGlobal(ip)
Throw New InvalidOperationException("Get Card ID fails. Errorcode: " & _
dwErrorCode.ToString, New System.ComponentModel.Win32Exception(dwErrorCode))
End If
Return erg
End Get
End Property
Sample Code:
public bool DeviceIoControl( IntPtr hDevice, uint dwIoControlCode, ref long buffer, int bufferSize, ref NativeOverlapped pOverlapped)
{
int NoReturn = 0;
return DeviceIoControl( hDevice, dwIoControlCode, ref buffer, bufferSize, ref buffer, bufferSize, ref NoReturn, ref pOverlapped );
}
public bool PlxIntrAttach(IntPtr handle, PlxIntr intrType)
{
// Call to PLX card to attach wait event to an Interrupts
// Declare control code
uint Control;
DriverMsgs AttachMsg = DriverMsgs.MsgIntrAttach;
Control = CtrCode( cFileDeviceUnknown, (int)AttachMsg, cMethodBuffered, cFileAnyAccess );
// Set return variable up
bool Status = false;
// Initialize the "buffer"
long DeviceBuffer = 0;
// Fill the buffer with the interrupt bitflag
DeviceBuffer = (long)intrType;
// Call the P/Invoked function through masking method
Status = DeviceIoControl( handle, Control, ref DeviceBuffer, 8, ref AdcOverlapData );
// Return with Status
return Status;
}
Alternative Managed API:
Do you know one? Please contribute it!
Alternative Managed API with necessary Flags defined:
using System;
using System.Threading;
using System.IO;
using System.Runtime.InteropServices;
using Microsoft.Win32.SafeHandles;
internal class DeviceIoOverlapped
{
private IntPtr mPtrOverlapped = IntPtr.Zero;
private int mFieldOffset_InternalLow = 0;
private int mFieldOffset_InternalHigh = 0;
private int mFieldOffset_OffsetLow = 0;
private int mFieldOffset_OffsetHigh = 0;
private int mFieldOffset_EventHandle = 0;
public DeviceIoOverlapped()
{
// Globally allocate the memory for the overlapped structure
mPtrOverlapped = Marshal.AllocHGlobal(Marshal.SizeOf(typeof (NativeOverlapped)));
public IntPtr InternalLow
{
get { return Marshal.ReadIntPtr(mPtrOverlapped, mFieldOffset_InternalLow); }
set { Marshal.WriteIntPtr(mPtrOverlapped, mFieldOffset_InternalLow, value); }
}
public IntPtr InternalHigh
{
get { return Marshal.ReadIntPtr(mPtrOverlapped, mFieldOffset_InternalHigh); }
set { Marshal.WriteIntPtr(mPtrOverlapped, mFieldOffset_InternalHigh, value); }
}
public int OffsetLow
{
get { return Marshal.ReadInt32(mPtrOverlapped, mFieldOffset_OffsetLow); }
set { Marshal.WriteInt32(mPtrOverlapped, mFieldOffset_OffsetLow, value); }
}
public int OffsetHigh
{
get { return Marshal.ReadInt32(mPtrOverlapped, mFieldOffset_OffsetHigh); }
set { Marshal.WriteInt32(mPtrOverlapped, mFieldOffset_OffsetHigh, value); }
}
/// <summary>
/// The overlapped event wait hande.
/// </summary>
public IntPtr EventHandle
{
get { return Marshal.ReadIntPtr(mPtrOverlapped, mFieldOffset_EventHandle); }
set { Marshal.WriteIntPtr(mPtrOverlapped, mFieldOffset_EventHandle, value); }
}
/// <summary>
/// Pass this into the DeviceIoControl and GetOverlappedResult APIs
/// </summary>
public IntPtr GlobalOverlapped
{
get { return mPtrOverlapped; }
}
/// <summary>
/// Set the overlapped wait handle and clear out the rest of the structure.
/// </summary>
/// <param name="hEventOverlapped"></param>
public void ClearAndSetEvent(IntPtr hEventOverlapped)
{
EventHandle = hEventOverlapped;
InternalLow = IntPtr.Zero;
InternalHigh = IntPtr.Zero;
OffsetLow = 0;
OffsetHigh = 0;
}
// Clean up the globally allocated memory.
~DeviceIoOverlapped()
{
if (mPtrOverlapped != IntPtr.Zero)
{
Marshal.FreeHGlobal(mPtrOverlapped);
mPtrOverlapped = IntPtr.Zero;
}
}
}
Use the above class something like this:
DeviceIoOverlapped deviceIoOverlapped = new DeviceIoOverlapped();
ManualResetEvent hEvent = new ManualResetEvent(false);
deviceIoOverlapped.ClearAndSetEvent(hEvent.SafeWaitHandle.DangerousGetHandle());
int ret;
DeviceIoControl(hDevice, iCtlCode, inBuffer, inSize, outBuffer, outSize, out ret, deviceIoOverlapped.GlobalOverlapped)
The DeviceIoControl API must declare an IntPtr for the OVERLAPPED parameter. All other deviations are OK.
TODO - a short description
3/31/2008 9:16:38 AM - anonymous
Click to read this page
3/31/2016 3:44:13 AM - oxewadrgwmo-85.235.206.106
Click to read this page
3/31/2016 3:44:13 AM - oxewadrgwmo-85.235.206.106
Click to read this page
3/31/2016 3:44:13 AM - oxewadrgwmo-85.235.206.106
Click to read this page
3/31/2016 3:44:13 AM - oxewadrgwmo-85.235.206.106
Click to read this page
3/31/2016 3:44:13 AM - oxewadrgwmo-85.235.206.106
Click to read this page
3/31/2016 3:44:13 AM - oxewadrgwmo-85.235.206.106
Click to read this page
3/31/2016 3:44:13 AM - oxewadrgwmo-85.235.206.106
An IntPtr is a pointer to a memory location (unmanaged) that adapts to the platform it is running on (64-bit, etc.) UNLIKE a standard int/Integer. You should always use this type for unmanaged calls that require it, even though an int will appear to work on your development machine.
1/13/2008 4:00:13 AM - Damon Carr-72.43.165.29
Please edit this page!
Do you have...
helpful tips or sample code to share for using this API in managed code?
corrections to the existing content?
variations of the signature you want to share?
additional languages you want to include?
Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).
Revisions