114 lines
3 KiB
C
114 lines
3 KiB
C
/*++
|
||
|
||
Copyright (c) 1989-1993 Microsoft Corporation
|
||
|
||
Module Name:
|
||
|
||
devctrl.c
|
||
|
||
Abstract:
|
||
|
||
This module contains the code to implement the NtDeviceIoControlFile system
|
||
service for the NT I/O system.
|
||
|
||
Author:
|
||
|
||
Darryl E. Havens (darrylh) 16-Oct-1989
|
||
|
||
Environment:
|
||
|
||
Kernel mode only
|
||
|
||
Revision History:
|
||
|
||
|
||
--*/
|
||
|
||
#include "iomgr.h"
|
||
|
||
#ifdef ALLOC_PRAGMA
|
||
#pragma alloc_text(PAGE, NtDeviceIoControlFile)
|
||
#endif
|
||
|
||
NTSTATUS
|
||
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
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
This service builds descriptors or MDLs for the supplied buffer(s) and
|
||
passes the untyped data to the device driver associated with the file
|
||
handle. It is up to the driver to check the input data and function
|
||
IoControlCode for validity, as well as to make the appropriate access
|
||
checks.
|
||
|
||
Arguments:
|
||
|
||
FileHandle - Supplies a handle to the file on which the service is being
|
||
performed.
|
||
|
||
Event - Supplies an optional event to be set to the Signaled state when
|
||
the service is complete.
|
||
|
||
ApcRoutine - Supplies an optional APC routine to be executed when the
|
||
service is complete.
|
||
|
||
ApcContext - Supplies a context parameter to be passed to the ApcRoutine,
|
||
if an ApcRoutine was specified.
|
||
|
||
IoStatusBlock - Address of the caller's I/O status block.
|
||
|
||
IoControlCode - Subfunction code to determine exactly what operation is
|
||
being performed.
|
||
|
||
InputBuffer - Optionally supplies an input buffer to be passed to the
|
||
device driver. Whether or not the buffer is actually optional is
|
||
dependent on the IoControlCode.
|
||
|
||
InputBufferLength - Length of the InputBuffer in bytes.
|
||
|
||
OutputBuffer - Optionally supplies an output buffer to receive information
|
||
from the device driver. Whether or not the buffer is actually optional
|
||
is dependent on the IoControlCode.
|
||
|
||
OutputBufferLength - Length of the OutputBuffer in bytes.
|
||
|
||
Return Value:
|
||
|
||
The status returned is success if the control operation was properly
|
||
queued to the I/O system. Once the operation completes, the status
|
||
can be determined by examining the Status field of the I/O status block.
|
||
|
||
--*/
|
||
|
||
{
|
||
//
|
||
// Simply invoke the common routine that implements both device and file
|
||
// system I/O controls.
|
||
//
|
||
|
||
return IopXxxControlFile( FileHandle,
|
||
Event,
|
||
ApcRoutine,
|
||
ApcContext,
|
||
IoStatusBlock,
|
||
IoControlCode,
|
||
InputBuffer,
|
||
InputBufferLength,
|
||
OutputBuffer,
|
||
OutputBufferLength,
|
||
TRUE );
|
||
}
|