NtDeviceIoControlFile

2OO1, 11 February

NTSYSAPI 
NTSTATUS
NTAPI


NtDeviceIoControlFile(



  IN HANDLE               FileHandle,
  IN HANDLE               Event OPTIONAL,
  IN PIO_APC_ROUTINE      ApcRoutine OPTIONAL,
  IN PVOID                ApcContext OPTIONAL,
  OUT PIO_STATUS_BLOCK    IoStatusBlock,
  IN ULONG                IoControlCode,
  IN PVOID                InputBuffer OPTIONAL,
  IN ULONG                InputBufferLength,
  OUT PVOID               OutputBuffer OPTIONAL,
  IN ULONG                OutputBufferLength );

Function NtDeviceIoControlFile sends IOCTL_* control code to Device Driver. It is primary (but not the best) solution to communicate between application and Device Driver.

FileHandle HANDLE to Device Object opened as a file.

Event Optional HANDLE to Event Object signalled on the end of processing request.

ApcRoutine Optional pointer to user's APC Routine called on the end of processing request.

ApcContext User's parameter to ApcRoutine.

IoStatusBlock IO result of call.

IoControlCode IO Control code [IOCTL_*].

InputBuffer User's allocated buffer with input data.

InputBufferLength Length of InputBuffer, in bytes.

OutputBuffer User's allocated buffer for result data.

OutputBufferLength Length of OutputBuffer, in bytes.

Undocumented functions of NTDLL