estructura DEVICE_OBJECT (wdm.h)
El sistema operativo usa la estructura DEVICE_OBJECT para representar un objeto de dispositivo. Un objeto de dispositivo representa un dispositivo lógico, virtual o físico para el que un controlador controla las solicitudes de E/S.
Sintaxis
typedef struct _DEVICE_OBJECT {
CSHORT Type;
USHORT Size;
LONG ReferenceCount;
struct _DRIVER_OBJECT *DriverObject;
struct _DEVICE_OBJECT *NextDevice;
struct _DEVICE_OBJECT *AttachedDevice;
struct _IRP *CurrentIrp;
PIO_TIMER Timer;
ULONG Flags;
ULONG Characteristics;
__volatile PVPB Vpb;
PVOID DeviceExtension;
DEVICE_TYPE DeviceType;
CCHAR StackSize;
union {
LIST_ENTRY ListEntry;
WAIT_CONTEXT_BLOCK Wcb;
} Queue;
ULONG AlignmentRequirement;
KDEVICE_QUEUE DeviceQueue;
KDPC Dpc;
ULONG ActiveThreadCount;
PSECURITY_DESCRIPTOR SecurityDescriptor;
KEVENT DeviceLock;
USHORT SectorSize;
USHORT Spare1;
struct _DEVOBJ_EXTENSION *DeviceObjectExtension;
PVOID Reserved;
} DEVICE_OBJECT, *PDEVICE_OBJECT;
Miembros
Type
Usado por el sistema operativo para indicar que un objeto es un objeto de dispositivo. En el caso de los objetos de dispositivo, el valor de este miembro es 3. Se trata de un miembro de solo lectura.
Size
Especifica el tamaño, en bytes, del objeto de dispositivo. Este tamaño incluye la extensión de dispositivo especificada por el controlador a la que apunta el miembro DeviceExtension , pero no incluye la extensión de objeto de dispositivo opaco a la que apunta el miembro DeviceObjectExtension . Size es un miembro de solo lectura.
ReferenceCount
Usado por el administrador de E/S para realizar un seguimiento del número de identificadores abiertos del dispositivo asociado al objeto de dispositivo. Esto permite que el administrador de E/S evite descargar un controlador cuando haya controladores pendientes para los dispositivos del controlador. Se trata de un miembro de solo lectura.
DriverObject
Puntero al objeto de controlador (DRIVER_OBJECT), que representa la imagen cargada del controlador que se ha introducido en las rutinas DriverEntry y AddDevice . El administrador de E/S establece este miembro tras una llamada correcta a IoCreateDevice o IoCreateDeviceSecure. Se trata de un miembro de solo lectura.
NextDevice
Puntero al siguiente objeto de dispositivo, si existe, creado por el mismo controlador. El administrador de E/S actualiza esta lista en cada llamada correcta a IoCreateDevice o IoCreateDeviceSecure.
Un controlador que no sea Plug and Play (PnP) que se está descargando debe atravesar ("walk") la lista de sus objetos de dispositivo y eliminarlos. Un controlador PnP no tiene que recorrer esta lista de objetos de dispositivo. En su lugar, los controladores PnP realizan su limpieza durante la operación PnP de eliminación del dispositivo (IRP_MN_REMOVE_DEVICE).
Un controlador que vuelve a crear sus objetos de dispositivo dinámicamente también usa este miembro. Se trata de un miembro de lectura y escritura.
AttachedDevice
Puntero al objeto de dispositivo conectado. Si no hay ningún objeto de dispositivo asociado, este miembro es NULL. El objeto de dispositivo al que apunta el miembro AttachedDevice suele ser el objeto de dispositivo de un controlador de filtro, que intercepta las solicitudes de E/S destinadas originalmente al dispositivo que representa el objeto de dispositivo. Para obtener más información, consulte los temas IoAttachDevice e IoAttachDeviceByPointer . Se trata de un miembro opaco.
CurrentIrp
Puntero al IRP actual si el controlador tiene una rutina StartIo cuyo punto de entrada se estableció en el objeto de controlador y si el controlador está procesando actualmente los IRP. De lo contrario, este miembro es NULL. Para obtener más información, consulte los temas IoStartPacket e IoStartNextPacket . Se trata de un miembro de solo lectura.
Timer
Puntero a un objeto de temporizador. Esto permite al administrador de E/S llamar a una rutina de temporizador proporcionada por el controlador cada segundo. Para obtener más información, consulte IoInitializeTimer. Se trata de un miembro de lectura y escritura.
Flags
Los controladores de dispositivo realizan una operación OR bit a bit con este miembro en sus objetos de dispositivo recién creados mediante uno o varios de los siguientes valores definidos por el sistema.
Para obtener más información sobre cómo establecer el miembro Flags , vea Inicializar un objeto device.
| Valor | Significado |
|---|---|
| DO_VERIFY_VOLUME (0x00000002) | Los controladores de medios extraíbles establecen esta marca mientras procesan las solicitudes de transferencia. Estos controladores también deben comprobar esta marca en el destino de una solicitud de transferencia antes de transferir los datos. Para obtener más información, vea el tema Compatibilidad con medios extraíbles . |
| DO_BUFFERED_IO (0x00000004) | Especifica el tipo de almacenamiento en búfer que usa el administrador de E/S para las solicitudes de E/S que se envían a la pila de dispositivos. Controladores de nivel superior O este miembro con el mismo valor que el controlador siguiente inferior de la pila, excepto posiblemente para los controladores de nivel superior. |
| DO_EXCLUSIVE (0x00000008) | Indica que el controlador atiende un dispositivo exclusivo, como un dispositivo de vídeo, serie, paralelo o sonido. Los controladores WDM no deben establecer esta marca. Para obtener más información, vea el tema Especificar el acceso exclusivo a objetos de dispositivo . |
| DO_DIRECT_IO (0x00000010) | Consulte DO_BUFFERED_IO. |
| DO_MAP_IO_BUFFER (0x00000020) | Esta marca ya no se usa. Los controladores no deben establecer esta marca. |
| DO_DEVICE_INITIALIZING (0x00000080) | El administrador de E/S establece esta marca cuando crea el objeto de dispositivo. Un controlador de función de dispositivo o un controlador de filtro borra la marca en su rutina AddDevice , después de ello: (1) Asocia el objeto de dispositivo a la pila de dispositivos. (2) Establece el estado de alimentación del dispositivo. (3) Realiza una operación OR bit a bit en el miembro con una de las marcas de alimentación (si es necesario). El administrador de Plug and Play (PnP) comprueba que la marca está desactivada después de que se devuelva la rutina AddDevice. |
| DO_SHUTDOWN_REGISTERED (0x00000800) | Usado por el administrador de E/S para indicar que un controlador ha registrado el objeto de dispositivo para las notificaciones de apagado. Los controladores no deben usar esta marca. |
| DO_BUS_ENUMERATED_DEVICE (0x00001000) | El sistema operativo establece esta marca en cada objeto de dispositivo físico (PDO). Los controladores no deben modificar esta marca. |
| DO_POWER_PAGABLE (0x00002000) | Los controladores paginables que son compatibles con Microsoft Windows 2000 y versiones posteriores de Windows, no forman parte de la ruta de acceso de paginación y no requieren que inrush current establezca esta marca. El sistema llama a estos controladores en IRQL = PASSIVE_LEVEL. Los controladores no pueden establecer esta marca y DO_POWER_INRUSH. Todos los controladores de WDM, Microsoft Windows 98 y Windows Millennium Edition deben establecer DO_POWER_PAGABLE. |
| DO_POWER_INRUSH (0x00004000) | Los controladores de dispositivos que requieren la corriente de entrada cuando el dispositivo está activado deben establecer esta marca. Un controlador no puede establecer esta marca y DO_POWER_PAGABLE. |
| DO_DEVICE_TO_BE_RESET (0x04000000) | El administrador de E/S establece esta marca como una señal para que el controlador de bus restablezca el dispositivo. Otros controladores no deben usar esta marca. |
| DO_DAX_VOLUME (0x10000000) | Indica que un volumen es un volumen DAX. |
Characteristics
Especifica una o varias constantes definidas por el sistema, combinadas con una operación OR bit a bit, que proporcionan información adicional sobre el dispositivo del controlador. Estas constantes incluyen lo siguiente:
| Valor | Significado |
|---|---|
| FILE_AUTOGENERATED_DEVICE_NAME | Dirige al administrador de E/S para generar un nombre para el dispositivo, en lugar del autor de la llamada que especifica un DeviceName cuando llama a esta rutina. El administrador de E/S se asegura de que el nombre es único. Esta característica se especifica normalmente mediante un controlador de bus PnP para generar un nombre para un objeto de dispositivo físico (PDO) para un dispositivo secundario en el mismo bus. |
| FILE_CHARACTERISTIC_PNP_DEVICE | Indica que el objeto de dispositivo forma parte de una pila de Plug and Play (PnP). Esta característica es necesaria si un controlador de bus (o controlador de filtro de bus) registra la compatibilidad con WMI para un objeto de dispositivo que aún no ha recibido la solicitud de IRP_MN_START_DEVICE . FILE_CHARACTERISTIC_PNP_DEVICE también es necesario si una función o un controlador de filtro se registra para WMI antes de asociarse a su pila de dispositivos. |
| FILE_CHARACTERISTIC_TS_DEVICE | Indica que el objeto de dispositivo forma parte de una pila de dispositivos de Terminal Services. Los controladores no deben establecer esta característica. |
| FILE_CHARACTERISTIC_WEBDAV_DEVICE | Indica que un sistema de archivos de creación y control de versiones distribuidos basado en web (WebDAV) está montado en el dispositivo. Los controladores no deben establecer esta característica. |
| FILE_DEVICE_IS_MOUNTED | Indica que un sistema de archivos está montado en el dispositivo. Los controladores no deben establecer esta característica. |
| FILE_DEVICE_SECURE_OPEN | Dirige al administrador de E/S para aplicar el descriptor de seguridad del objeto de dispositivo a las aperturas relativas y se abre el nombre de archivo final del dispositivo. Para obtener más información, consulte el tema Control del acceso al espacio de nombres del dispositivo . |
| FILE_FLOPPY_DISKETTE | Indica que el dispositivo es un dispositivo de disquete. |
| FILE_READ_ONLY_DEVICE | Indica que el dispositivo no se puede escribir en. |
| FILE_REMOTE_DEVICE | Indica que el dispositivo es remoto. |
| FILE_REMOVABLE_MEDIA | Indica que el dispositivo de almacenamiento admite medios extraíbles. Tenga en cuenta que esta característica indica medios extraíbles, no un dispositivo extraíble. Por ejemplo, los controladores para dispositivos de unidad JAZ deben especificar esta característica, pero los controladores para los discos flash PCMCIA no deben. |
| FILE_VIRTUAL_VOLUME | Indica que el volumen es virtual. Los controladores no deben establecer esta característica. |
| FILE_WRITE_ONCE_MEDIA | Indica que el dispositivo admite medios de escritura una vez. Los controladores no establecen este miembro directamente. Para obtener más información sobre cómo establecer las características del dispositivo, consulte el tema Especificar características del dispositivo . |
| FILE_CHARACTERISTIC_CSV | Indica que el dispositivo es un volumen compartido de clúster (CSV). |
| FILE_DEVICE_ALLOW_APPCONTAINER_TRAVERSAL | Normalmente, el Administrador de E/S realiza una comprobación de seguridad completa para recorrer el acceso en todos los archivos abiertos cuando el cliente es un contenedor de aplicaciones. La configuración de esta marca omite esta comprobación de acceso de recorrido aplicada si el token de cliente ya tiene privilegios de recorrido. |
| FILE_PORTABLE_DEVICE | Indica que la pila subyacente considera el dispositivo portátil. Esto lo usa la pila de almacenamiento y significa que el dispositivo no está en el contenedor de la máquina local y no está en un tipo de bus fijo. |
Vpb
Puntero al bloque de parámetros de volumen (VPB) asociado al objeto de dispositivo. En el caso de los controladores del sistema de archivos, el VPB puede proporcionar una conexión a cualquier objeto de dispositivo lógico sin nombre que represente una instancia de un volumen montado. Se trata de un miembro opaco.
DeviceExtension
Puntero a la extensión del dispositivo. La estructura y el contenido de la extensión de dispositivo están definidos por el controlador. El tamaño está determinado por el controlador, especificado en la llamada del controlador a IoCreateDevice o IoCreateDeviceSecure. Para obtener más información sobre las extensiones de dispositivo, consulte Extensiones de dispositivo. Se trata de un miembro de solo lectura. Sin embargo, el controlador puede modificar el objeto al que apunta el miembro.
DeviceType
Se establece mediante IoCreateDevice e IoCreateDeviceSecure mediante el valor especificado para el parámetro DeviceType de esa rutina. Para obtener más información, consulte el tema Especificar tipos de dispositivo .
StackSize
Especifica el número mínimo de ubicaciones de pila en irP que se enviarán a este controlador. IoCreateDevice e IoCreateDeviceSecure establecen este miembro en 1 en objetos de dispositivo recién creados; Por lo tanto, los controladores de nivel más bajo pueden omitir este miembro. El administrador de E/S establece automáticamente el miembro StackSize en un objeto de dispositivo de controlador de nivel superior en el valor adecuado si el controlador llama a IoAttachDevice o IoAttachDeviceToDeviceStack. Solo un controlador de nivel superior que se encadene a otro controlador con IoGetDeviceObjectPointer debe establecer explícitamente el valor de StackSize en sus propios objetos de dispositivo en 1 + el valor StackSize del objeto de dispositivo del controlador siguiente inferior.
Queue
Lo usa internamente el administrador de E/S para poner en cola el objeto de dispositivo cuando es necesario. Se trata de un miembro opaco.
Queue.ListEntry
Estructura LIST_ENTRY que contiene punteros hacia delante y hacia atrás para una lista vinculada doblemente.
Queue.Wcb
Información de contexto del dispositivo utilizada por el administrador de E/S.
AlignmentRequirement
Especifica el requisito de alineación de direcciones del dispositivo para las transferencias de datos. El valor debe ser uno de los valores FILE_XXX_ALIGNMENT definidos en Wdm.h. Para obtener más información, consulte los temas Inicialización de un objeto device, GetDmaAlignment y ZwQueryInformationFile .
DeviceQueue
Objeto de cola de dispositivos para el objeto de dispositivo. El objeto de cola de dispositivos contiene los IRP que están esperando que el controlador asociado al objeto de dispositivo procese. Para obtener más información, consulte el tema Colas de IRP administradas por controladores . Se trata de un miembro opaco.
Dpc
Objeto de llamada a procedimiento diferido (DPC) para el objeto de dispositivo. Para obtener más información, vea el tema Introducción a objetos DPC . Se trata de un miembro opaco.
ActiveThreadCount
Reservado para uso futuro. Se trata de un miembro opaco.
SecurityDescriptor
Especifica un descriptor de seguridad (SECURITY_DESCRIPTOR) para el objeto de dispositivo cuando se crea el objeto de dispositivo. Si este miembro es NULL, el objeto de dispositivo recibe la configuración de seguridad predeterminada. Se trata de un miembro de solo lectura, aunque el miembro se puede modificar a través de la función ZwSetSecurityObject .
DeviceLock
Objeto de evento de sincronización asignado por el administrador de E/S. El administrador de E/S obtiene su objeto de evento antes de enviar una solicitud de montaje o comprobación de montaje a un controlador del sistema de archivos. Se trata de un miembro opaco.
SectorSize
Si el objeto de dispositivo no representa un volumen, este miembro se establece en cero. Si el objeto de dispositivo representa un volumen, este miembro especifica el tamaño del sector del volumen, en bytes. El administrador de E/S usa este miembro para asegurarse de que todas las operaciones de lectura, operaciones de escritura y establecer operaciones de posición de archivo emitidas se alinean correctamente cuando se deshabilita el almacenamiento en búfer intermedio. Sin embargo, se usa un valor predeterminado de bytes por sector del sistema cuando se crea el objeto de dispositivo; sin embargo, los controladores del sistema de archivos; y, más rara vez, los controladores heredados y minifiltros pueden actualizar este valor que se basa en la geometría del hardware del volumen subyacente cuando se produce un montaje. Otros controladores no deben modificar este miembro.
Spare1
Reservado para uso del sistema. Se trata de un miembro opaco.
DeviceObjectExtension
Puntero a una extensión de objeto de dispositivo que usa el administrador de E/S y el administrador de PnP para almacenar información sobre el estado del dispositivo. Se trata de un miembro opaco.
Reserved
Reservado para uso del sistema. Se trata de un miembro opaco.
Comentarios
El sistema operativo representa los dispositivos por objetos de dispositivo. Para obtener más información, consulte el tema Objetos de dispositivo y Pilas de dispositivos .
Los controladores crean objetos de dispositivo mediante las rutinas IoCreateDevice e IoCreateDeviceSecure . Para obtener más información sobre cómo crear objetos de dispositivo, consulte Creación de un objeto de dispositivo.
Un objeto de dispositivo es parcialmente opaco. Los controladores no establecen miembros del objeto de dispositivo directamente, a menos que se documente lo contrario. Para obtener más información sobre los miembros que los controladores pueden modificar directamente, vea Inicializar un objeto de dispositivo. Para obtener información sobre otras propiedades de objeto de dispositivo, vea Propiedades de objetos de dispositivo.
Los miembros opacos de un objeto de dispositivo deben considerarse inaccesibles. Es posible que los controladores que tengan dependencias en ubicaciones de miembros de objeto o el acceso a miembros opacos no permanezcan portátiles e interoperables con otros controladores a lo largo del tiempo.
El controlador de puerto de vídeo proporcionado por el sistema configura los campos de los objetos de dispositivo que crea en nombre de los controladores de minipuerto de vídeo.
El controlador de puerto SCSI proporcionado por el sistema configura los campos de los objetos de dispositivo que crea en nombre de los controladores de miniporte SCSI.
La biblioteca NDIS proporcionada por el sistema configura los campos de los objetos de dispositivo que crea en nombre de los controladores de miniporte de NDIS.
Requisitos
| Requisito | Valor |
|---|---|
| Header | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h) |