Función IoGetDeviceDirectory (wdm.h)
Devuelve un identificador a un directorio en el disco, en el que los controladores pueden almacenar archivos. Los archivos de ese directorio se aplican a una instancia de dispositivo específica.
NTSTATUS IoGetDeviceDirectory(
[_In_] PDEVICE_OBJECT PhysicalDeviceObject,
[_In_] DEVICE_DIRECTORY_TYPE DirectoryType,
[_In_] ULONG Flags,
[_In_] PVOID Reserved,
[_Out_] PHANDLE DeviceDirectoryHandle
);
[_In_] PhysicalDeviceObject
Puntero a la objeto de dispositivo físico consultar en la pila de dispositivos de una instancia de dispositivo determinada. No debe ser NULL.
[_In_] DirectoryType
Valor de tipo _DEVICE_DIRECTORY_TYPEque indica el tipo de directorio solicitado.
[_In_] Flags
Debe ser 0.
[_In_] Reserved
Reservado. Debe ser NULL.
[_Out_] DeviceDirectoryHandle
Puntero a una variable que recibe un IDENTIFICADOR al directorio de dispositivo solicitado. El autor de la llamada no debe pasar NULL.
Devuelve un valor NTSTATUS adecuado . Entre los valores posibles se incluyen:
Código de error | Descripción |
---|---|
STATUS_SUCCESS | La llamada abrió correctamente un identificador en el directorio del dispositivo solicitado. |
STATUS_INVALID_PARAMETER | Un valor de entrada para esta función no es válido. Por ejemplo, PhysicalDeviceObject o DeviceDirectoryHandle es NULL; marcas no es 0; reservado no es NULL. |
Si se llama a ioGetDeviceDirectory antes de que se hayan iniciado los discos y volúmenes necesarios, la función no abre un identificador y devuelve un error.
Los controladores suelen usar ZwOpenFile y ZwCreateFile para acceder o crear archivos. Uno de los parámetros de esas funciones es una estructura OBJECT_ATTRIBUTES, que contiene el nombre del objeto y un directorio raíz. Si el directorio raíz es NULL, el nombre del objeto debe ser una ruta de acceso completa. Sin embargo, si proporciona un identificador para el directorio raíz, el nombre del objeto debe ser relativo al objeto (en el caso de los archivos, el directorio), que representa el identificador.
Después de que la llamada IoGetDeviceDirectory se realice correctamente, use el IDENTIFICADOR recibido como directorio raíz en el OBJECT_ATTRIBUTES que va a pasar a unZwOpenFiley ZwCreateFile.
El controlador debe llamar a ZwClose para cerrar el identificador recibido cuando el acceso ya no sea necesario.
Los autores de llamadas de ioGetDeviceDirectory deben ejecutarse en IRQL = PASSIVE_LEVEL en el contexto de un subproceso del sistema.
Requisito | Valor |
---|---|
cliente mínimo admitido | Windows 10, versión 1803 |
encabezado de | wdm.h |
biblioteca de | NtosKrnl.lib |
DLL de | NtosKrnl.exe |
irQL | PASSIVE_LEVEL |