3 * COPYRIGHT: See COPYING in the top level directory
4 * PROJECT: ReactOS kernel
5 * FILE: ntoskrnl/io/dir.c
6 * PURPOSE: Directory functions
7 * PROGRAMMER: David Welch (welch@mcmail.com)
12 /* INCLUDES *****************************************************************/
14 #include <ddk/ntddk.h>
15 #include <internal/io.h>
18 #include <internal/debug.h>
20 /* FUNCTIONS *****************************************************************/
26 NtNotifyChangeDirectoryFile (
28 IN HANDLE Event OPTIONAL,
29 IN PIO_APC_ROUTINE ApcRoutine OPTIONAL,
30 IN PVOID ApcContext OPTIONAL,
31 OUT PIO_STATUS_BLOCK IoStatusBlock,
34 IN ULONG CompletionFilter,
46 IN HANDLE PEvent OPTIONAL,
47 IN PIO_APC_ROUTINE ApcRoutine OPTIONAL,
48 IN PVOID ApcContext OPTIONAL,
49 OUT PIO_STATUS_BLOCK IoStatusBlock,
50 OUT PVOID FileInformation,
52 IN FILE_INFORMATION_CLASS FileInformationClass,
53 IN BOOLEAN ReturnSingleEntry,
54 IN PUNICODE_STRING FileName OPTIONAL,
55 IN BOOLEAN RestartScan
58 * FUNCTION: Queries a directory file.
60 * FileHandle = Handle to a directory file
61 * EventHandle = Handle to the event signaled on completion
62 * ApcRoutine = Asynchroneous procedure callback, called on completion
63 * ApcContext = Argument to the apc.
64 * IoStatusBlock = Caller supplies storage for extended status information.
65 * FileInformation = Caller supplies storage for the resulting information.
67 * FileNameInformation FILE_NAMES_INFORMATION
68 * FileDirectoryInformation FILE_DIRECTORY_INFORMATION
69 * FileFullDirectoryInformation FILE_FULL_DIRECTORY_INFORMATION
70 * FileBothDirectoryInformation FILE_BOTH_DIR_INFORMATION
72 * Length = Size of the storage supplied
73 * FileInformationClass = Indicates the type of information requested.
74 * ReturnSingleEntry = Specify true if caller only requests the first
76 * FileName = Initial directory name to query, that may contain wild
78 * RestartScan = Number of times the action should be repeated
79 * RETURNS: Status [ STATUS_SUCCESS, STATUS_ACCESS_DENIED, STATUS_INSUFFICIENT_RESOURCES,
80 * STATUS_INVALID_PARAMETER, STATUS_INVALID_DEVICE_REQUEST, STATUS_BUFFER_OVERFLOW,
81 * STATUS_INVALID_INFO_CLASS, STATUS_NO_SUCH_FILE, STATUS_NO_MORE_FILES ]
85 PDEVICE_OBJECT DeviceObject;
86 PFILE_OBJECT FileObject;
88 PIO_STACK_LOCATION IoStack;
91 DPRINT("NtQueryDirectoryFile()\n");
93 Status = ObReferenceObjectByHandle(FileHandle,
100 if (Status != STATUS_SUCCESS)
102 ObDereferenceObject(FileObject);
105 DeviceObject = FileObject->DeviceObject;
107 Irp = IoAllocateIrp(DeviceObject->StackSize, TRUE);
110 ObDereferenceObject(FileObject);
111 return STATUS_UNSUCCESSFUL;
115 Irp->UserIosb = &IoSB;
116 Irp->UserEvent = &FileObject->Event;
117 KeResetEvent( &FileObject->Event );
118 Irp->UserBuffer=FileInformation;
120 IoStack = IoGetNextIrpStackLocation(Irp);
122 IoStack->MajorFunction = IRP_MJ_DIRECTORY_CONTROL;
123 IoStack->MinorFunction = IRP_MN_QUERY_DIRECTORY;
125 IoStack->Control = 0;
126 IoStack->DeviceObject = DeviceObject;
127 IoStack->FileObject = FileObject;
131 IoStack->Flags = IoStack->Flags | SL_RESTART_SCAN;
133 if (ReturnSingleEntry)
135 IoStack->Flags = IoStack->Flags | SL_RETURN_SINGLE_ENTRY;
137 if (((PFILE_DIRECTORY_INFORMATION)FileInformation)->FileIndex != 0)
139 IoStack->Flags = IoStack->Flags | SL_INDEX_SPECIFIED;
142 IoStack->Parameters.QueryDirectory.FileInformationClass =
143 FileInformationClass;
144 IoStack->Parameters.QueryDirectory.FileName = FileName;
145 IoStack->Parameters.QueryDirectory.Length = Length;
147 Status = IoCallDriver(FileObject->DeviceObject,Irp);
148 if (Status==STATUS_PENDING && !(FileObject->Flags & FO_SYNCHRONOUS_IO))
150 if (FileObject->Flags & FO_ALERTABLE_IO)
152 KeWaitForSingleObject(&FileObject->Event,Executive,KernelMode,TRUE,NULL);
156 KeWaitForSingleObject(&FileObject->Event,Executive,KernelMode,FALSE,NULL);
158 Status = IoSB.Status;
162 *IoStatusBlock = IoSB;
167 NTSTATUS STDCALL NtQueryOleDirectoryFile(VOID)