system/wine
system/wine
1
0
Fork 0
mirror of git://source.winehq.org/git/wine.git synced 2024-09-18 10:16:26 +00:00
Code Issues Packages Projects Releases Wiki Activity

Documentation updates.

Browse source
This commit is contained in:
Jon Griffiths 2003-07-18 22:55:28 +00:00 committed by Alexandre Julliard
parent b62fb40f54
commit 7787587587
1 changed files with 155 additions and 54 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

209
dlls/ntdll/file.c
View file

@ -49,14 +49,20 @@ WINE_DEFAULT_DEBUG_CHANNEL(ntdll);
/************************************************************************** /**************************************************************************
* NtOpenFile [NTDLL.@] * NtOpenFile [NTDLL.@]
* ZwOpenFile [NTDLL.@] * ZwOpenFile [NTDLL.@]
* FUNCTION: Opens a file *
* ARGUMENTS: * Open a file.
* FileHandle Variable that receives the file handle on return *
* DesiredAccess Access desired by the caller to the file * PARAMS
* ObjectAttributes Structue describing the file to be opened * FileHandle [O] Variable that receives the file handle on return
* IoStatusBlock Receives details about the result of the operation * DesiredAccess [I] Access desired by the caller to the file
* ShareAccess Type of shared access the caller requires * ObjectAttributes [I] Structue describing the file to be opened
* OpenOptions Options for the file open * IoStatusBlock [O] Receives details about the result of the operation
* ShareAccess [I] Type of shared access the caller requires
* OpenOptions [I] Options for the file open
*
* RETURNS
* Success: 0. FileHandle and IoStatusBlock are updated.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtOpenFile( NTSTATUS WINAPI NtOpenFile(
OUT PHANDLE FileHandle, OUT PHANDLE FileHandle,
@ -118,22 +124,26 @@ NTSTATUS WINAPI NtOpenFile(
/************************************************************************** /**************************************************************************
* NtCreateFile [NTDLL.@] * NtCreateFile [NTDLL.@]
* ZwCreateFile [NTDLL.@] * ZwCreateFile [NTDLL.@]
* FUNCTION: Either causes a new file or directory to be created, or it opens *
* an existing file, device, directory or volume, giving the caller a handle * Either create a new file or directory, or open an existing file, device,
* for the file object. This handle can be used by subsequent calls to * directory or volume.
* manipulate data within the file or the file object's state of attributes. *
* ARGUMENTS: * PARAMS
* FileHandle Points to a variable which receives the file handle on return * FileHandle [O] Points to a variable which receives the file handle on return
* DesiredAccess Desired access to the file * DesiredAccess [I] Desired access to the file
* ObjectAttributes Structure describing the file * ObjectAttributes [I] Structure describing the file
* IoStatusBlock Receives information about the operation on return * IoStatusBlock [O] Receives information about the operation on return
* AllocationSize Initial size of the file in bytes * AllocationSize [I] Initial size of the file in bytes
* FileAttributes Attributes to create the file with * FileAttributes [I] Attributes to create the file with
* ShareAccess Type of shared access the caller would like to the file * ShareAccess [I] Type of shared access the caller would like to the file
* CreateDisposition Specifies what to do, depending on whether the file already exists * CreateDisposition [I] Specifies what to do, depending on whether the file already exists
* CreateOptions Options for creating a new file * CreateOptions [I] Options for creating a new file
* EaBuffer Undocumented * EaBuffer [I] Undocumented
* EaLength Undocumented * EaLength [I] Undocumented
*
* RETURNS
* Success: 0. FileHandle and IoStatusBlock are updated.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtCreateFile( NTSTATUS WINAPI NtCreateFile(
OUT PHANDLE FileHandle, OUT PHANDLE FileHandle,
@ -332,21 +342,26 @@ static void FILE_AsyncReadService(async_private *ovp)
* NtReadFile [NTDLL.@] * NtReadFile [NTDLL.@]
* ZwReadFile [NTDLL.@] * ZwReadFile [NTDLL.@]
* *
* Parameters * Read from an open file handle.
* HANDLE32 hFile
* HANDLE32 hEvent OPTIONAL
* PIO_APC_ROUTINE apc OPTIONAL
* PVOID apc_user OPTIONAL
* PIO_STATUS_BLOCK io_status
* PVOID buffer
* ULONG length
* PLARGE_INTEGER offset OPTIONAL
* PULONG key OPTIONAL
* *
* IoStatusBlock->Information contains the number of bytes read on return. * PARAMS
* FileHandle [I] Handle returned from ZwOpenFile() or ZwCreateFile()
* Event [I] Event to signal upon completion (or NULL)
* ApcRoutine [I] Callback to call upon completion (or NULL)
* ApcContext [I] Context for ApcRoutine (or NULL)
* IoStatusBlock [O] Receives information about the operation on return
* Buffer [O] Destination for the data read
* Length [I] Size of Buffer
* ByteOffset [O] Destination for the new file pointer position (or NULL)
* Key [O] Function unknown (may be NULL)
*
* RETURNS
* Success: 0. IoStatusBlock is updated, and the Information member contains
* The number of bytes read.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtReadFile(HANDLE hFile, HANDLE hEvent, NTSTATUS WINAPI NtReadFile(HANDLE hFile, HANDLE hEvent,
PIO_APC_ROUTINE apc, void* apc_user, PIO_APC_ROUTINE apc, void* apc_user,
PIO_STATUS_BLOCK io_status, void* buffer, ULONG length, PIO_STATUS_BLOCK io_status, void* buffer, ULONG length,
PLARGE_INTEGER offset, PULONG key) PLARGE_INTEGER offset, PULONG key)
{ {
@ -371,7 +386,7 @@ NTSTATUS WINAPI NtReadFile(HANDLE hFile, HANDLE hEvent,
io_status->u.Status = NtCreateEvent(&hEvent, SYNCHRONIZE, NULL, 0, 0); io_status->u.Status = NtCreateEvent(&hEvent, SYNCHRONIZE, NULL, 0, 0);
if (io_status->u.Status) return io_status->u.Status; if (io_status->u.Status) return io_status->u.Status;
} }
if (flags & (FD_FLAG_OVERLAPPED|FD_FLAG_TIMEOUT)) if (flags & (FD_FLAG_OVERLAPPED|FD_FLAG_TIMEOUT))
{ {
async_fileio* ovp; async_fileio* ovp;
@ -495,16 +510,23 @@ static void FILE_AsyncWriteService(struct async_private *ovp)
* NtWriteFile [NTDLL.@] * NtWriteFile [NTDLL.@]
* ZwWriteFile [NTDLL.@] * ZwWriteFile [NTDLL.@]
* *
* Parameters * Write to an open file handle.
* HANDLE32 hFile *
* HANDLE32 hEvent OPTIONAL * PARAMS
* PIO_APC_ROUTINE apc OPTIONAL * FileHandle [I] Handle returned from ZwOpenFile() or ZwCreateFile()
* PVOID apc_user OPTIONAL * Event [I] Event to signal upon completion (or NULL)
* PIO_STATUS_BLOCK io_status * ApcRoutine [I] Callback to call upon completion (or NULL)
* PVOID buffer * ApcContext [I] Context for ApcRoutine (or NULL)
* ULONG length * IoStatusBlock [O] Receives information about the operation on return
* PLARGE_INTEGER offset OPTIONAL * Buffer [I] Source for the data to write
* PULONG key OPTIONAL * Length [I] Size of Buffer
* ByteOffset [O] Destination for the new file pointer position (or NULL)
* Key [O] Function unknown (may be NULL)
*
* RETURNS
* Success: 0. IoStatusBlock is updated, and the Information member contains
* The number of bytes written.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtWriteFile(HANDLE hFile, HANDLE hEvent, NTSTATUS WINAPI NtWriteFile(HANDLE hFile, HANDLE hEvent,
PIO_APC_ROUTINE apc, void* apc_user, PIO_APC_ROUTINE apc, void* apc_user,
@ -580,7 +602,7 @@ NTSTATUS WINAPI NtWriteFile(HANDLE hFile, HANDLE hEvent,
FILE_POSITION_INFORMATION fpi; FILE_POSITION_INFORMATION fpi;
fpi.CurrentByteOffset = *offset; fpi.CurrentByteOffset = *offset;
io_status->u.Status = NtSetInformationFile(hFile, io_status, &fpi, sizeof(fpi), io_status->u.Status = NtSetInformationFile(hFile, io_status, &fpi, sizeof(fpi),
FilePositionInformation); FilePositionInformation);
if (io_status->u.Status) if (io_status->u.Status)
{ {
@ -605,6 +627,24 @@ NTSTATUS WINAPI NtWriteFile(HANDLE hFile, HANDLE hEvent,
/************************************************************************** /**************************************************************************
* NtDeviceIoControlFile [NTDLL.@] * NtDeviceIoControlFile [NTDLL.@]
* ZwDeviceIoControlFile [NTDLL.@] * ZwDeviceIoControlFile [NTDLL.@]
*
* Perform an I/O control operation on an open file handle.
*
* PARAMS
* DeviceHandle [I] Handle returned from ZwOpenFile() or ZwCreateFile()
* Event [I] Event to signal upon completion (or NULL)
* ApcRoutine [I] Callback to call upon completion (or NULL)
* ApcContext [I] Context for ApcRoutine (or NULL)
* IoStatusBlock [O] Receives information about the operation on return
* IoControlCode [I] Control code for the operation to perform
* InputBuffer [I] Source for any input data required (or NULL)
* InputBufferSize [I] Size of InputBuffer
* OutputBuffer [O] Source for any output data returned (or NULL)
* OutputBufferSize [I] Size of OutputBuffer
*
* RETURNS
* Success: 0. IoStatusBlock is updated.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtDeviceIoControlFile(HANDLE DeviceHandle, HANDLE hEvent, NTSTATUS WINAPI NtDeviceIoControlFile(HANDLE DeviceHandle, HANDLE hEvent,
PIO_APC_ROUTINE UserApcRoutine, PIO_APC_ROUTINE UserApcRoutine,
@ -678,6 +718,19 @@ NTSTATUS WINAPI NtFsControlFile(
/****************************************************************************** /******************************************************************************
* NtSetVolumeInformationFile [NTDLL.@] * NtSetVolumeInformationFile [NTDLL.@]
* ZwSetVolumeInformationFile [NTDLL.@] * ZwSetVolumeInformationFile [NTDLL.@]
*
* Set volume information for an open file handle.
*
* PARAMS
* FileHandle [I] Handle returned from ZwOpenFile() or ZwCreateFile()
* IoStatusBlock [O] Receives information about the operation on return
* FsInformation [I] Source for volume information
* Length [I] Size of FsInformation
* FsInformationClass [I] Type of volume information to set
*
* RETURNS
* Success: 0. IoStatusBlock is updated.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtSetVolumeInformationFile( NTSTATUS WINAPI NtSetVolumeInformationFile(
IN HANDLE FileHandle, IN HANDLE FileHandle,
@ -694,6 +747,19 @@ NTSTATUS WINAPI NtSetVolumeInformationFile(
/****************************************************************************** /******************************************************************************
* NtQueryInformationFile [NTDLL.@] * NtQueryInformationFile [NTDLL.@]
* ZwQueryInformationFile [NTDLL.@] * ZwQueryInformationFile [NTDLL.@]
*
* Get information about an open file handle.
*
* PARAMS
* FileHandle [I] Handle returned from ZwOpenFile() or ZwCreateFile()
* IoStatusBlock [O] Receives information about the operation on return
* FileInformation [O] Destination for file information
* Length [I] Size of FileInformation
* FileInformationClass [I] Type of file information to get
*
* RETURNS
* Success: 0. IoStatusBlock and FileInformation are updated.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtQueryInformationFile(HANDLE hFile, PIO_STATUS_BLOCK io_status, NTSTATUS WINAPI NtQueryInformationFile(HANDLE hFile, PIO_STATUS_BLOCK io_status,
PVOID ptr, LONG len, PVOID ptr, LONG len,
@ -815,9 +881,22 @@ NTSTATUS WINAPI NtQueryInformationFile(HANDLE hFile, PIO_STATUS_BLOCK io_status,
/****************************************************************************** /******************************************************************************
* NtSetInformationFile [NTDLL.@] * NtSetInformationFile [NTDLL.@]
* ZwSetInformationFile [NTDLL.@] * ZwSetInformationFile [NTDLL.@]
*
* Set information about an open file handle.
*
* PARAMS
* FileHandle [I] Handle returned from ZwOpenFile() or ZwCreateFile()
* IoStatusBlock [O] Receives information about the operation on return
* FileInformation [I] Source for file information
* Length [I] Size of FileInformation
* FileInformationClass [I] Type of file information to set
*
* RETURNS
* Success: 0. IoStatusBlock is updated.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtSetInformationFile(HANDLE hFile, PIO_STATUS_BLOCK io_status, NTSTATUS WINAPI NtSetInformationFile(HANDLE hFile, PIO_STATUS_BLOCK io_status,
PVOID ptr, ULONG len, PVOID ptr, ULONG len,
FILE_INFORMATION_CLASS class) FILE_INFORMATION_CLASS class)
{ {
NTSTATUS status = STATUS_INVALID_PARAMETER_3; NTSTATUS status = STATUS_INVALID_PARAMETER_3;
@ -825,7 +904,7 @@ NTSTATUS WINAPI NtSetInformationFile(HANDLE hFile, PIO_STATUS_BLOCK io_status,
TRACE("(%p,%p,%p,0x%08lx,0x%08x)\n", hFile, io_status, ptr, len, class); TRACE("(%p,%p,%p,0x%08lx,0x%08x)\n", hFile, io_status, ptr, len, class);
switch (class) switch (class)
{ {
case FilePositionInformation: case FilePositionInformation:
if (len >= sizeof(FILE_POSITION_INFORMATION)) if (len >= sizeof(FILE_POSITION_INFORMATION))
{ {
@ -855,7 +934,6 @@ NTSTATUS WINAPI NtSetInformationFile(HANDLE hFile, PIO_STATUS_BLOCK io_status,
/****************************************************************************** /******************************************************************************
* NtQueryDirectoryFile [NTDLL.@] * NtQueryDirectoryFile [NTDLL.@]
* ZwQueryDirectoryFile [NTDLL.@] * ZwQueryDirectoryFile [NTDLL.@]
* ZwQueryDirectoryFile
*/ */
NTSTATUS WINAPI NtQueryDirectoryFile( NTSTATUS WINAPI NtQueryDirectoryFile(
IN HANDLE FileHandle, IN HANDLE FileHandle,
@ -880,6 +958,19 @@ NTSTATUS WINAPI NtQueryDirectoryFile(
/****************************************************************************** /******************************************************************************
* NtQueryVolumeInformationFile [NTDLL.@] * NtQueryVolumeInformationFile [NTDLL.@]
* ZwQueryVolumeInformationFile [NTDLL.@] * ZwQueryVolumeInformationFile [NTDLL.@]
*
* Get volume information for an open file handle.
*
* PARAMS
* FileHandle [I] Handle returned from ZwOpenFile() or ZwCreateFile()
* IoStatusBlock [O] Receives information about the operation on return
* FsInformation [O] Destination for volume information
* Length [I] Size of FsInformation
* FsInformationClass [I] Type of volume information to set
*
* RETURNS
* Success: 0. IoStatusBlock and FsInformation are updated.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtQueryVolumeInformationFile ( NTSTATUS WINAPI NtQueryVolumeInformationFile (
IN HANDLE FileHandle, IN HANDLE FileHandle,
@ -973,6 +1064,16 @@ NTSTATUS WINAPI NtQueryVolumeInformationFile (
/****************************************************************** /******************************************************************
* NtFlushBuffersFile (NTDLL.@) * NtFlushBuffersFile (NTDLL.@)
*
* Flush any buffered data on an open file handle.
*
* PARAMS
* FileHandle [I] Handle returned from ZwOpenFile() or ZwCreateFile()
* IoStatusBlock [O] Receives information about the operation on return
*
* RETURNS
* Success: 0. IoStatusBlock is updated.
* Failure: An NTSTATUS error code describing the error.
*/ */
NTSTATUS WINAPI NtFlushBuffersFile( HANDLE hFile, IO_STATUS_BLOCK* IoStatusBlock ) NTSTATUS WINAPI NtFlushBuffersFile( HANDLE hFile, IO_STATUS_BLOCK* IoStatusBlock )
{ {
@ -1000,8 +1101,8 @@ NTSTATUS WINAPI NtFlushBuffersFile( HANDLE hFile, IO_STATUS_BLOCK* IoStatusBlock
* *
*/ */
NTSTATUS WINAPI NtLockFile( HANDLE hFile, HANDLE lock_granted_event, NTSTATUS WINAPI NtLockFile( HANDLE hFile, HANDLE lock_granted_event,
PIO_APC_ROUTINE apc, void* apc_user, PIO_APC_ROUTINE apc, void* apc_user,
PIO_STATUS_BLOCK io_status, PLARGE_INTEGER offset, PIO_STATUS_BLOCK io_status, PLARGE_INTEGER offset,
PLARGE_INTEGER count, ULONG* key, BOOLEAN dont_wait, PLARGE_INTEGER count, ULONG* key, BOOLEAN dont_wait,
BOOLEAN exclusive ) BOOLEAN exclusive )
{ {