Función SerCx2InitializeDeviceInit (sercx.h)

Artículo
10/30/2024

El método SerCx2InitializeDeviceInit habilita la versión 2 de la extensión de marco serie (SerCx2) para registrar propiedades específicas de la extensión con el marco de trabajo del controlador durante la creación del objeto de dispositivo de marco para el controlador serie.

Sintaxis

NTSTATUS SerCx2InitializeDeviceInit(
  [in, out] PWDFDEVICE_INIT DeviceInit
);

Parámetros

[in, out] DeviceInit

Puntero a una estructura de WDFDEVICE_INIT, que es una estructura opaca que almacena información que usa el marco de controlador del modo kernel (KMDF) para crear un objeto de dispositivo de marco. El controlador de controlador serie recibe un puntero a esta estructura como parámetro de entrada para la función de devolución de llamada del controlador EvtDriverDeviceAdd función de devolución de llamada.

Valor devuelto

SerCx2InitializeDeviceInit devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.

Código devuelto	Descripción
STATUS_INVALID_DEVICE_REQUEST	Se llamó al método en IRQL incorrecto o el parámetro DeviceInit es NULL.
STATUS_INSUFFICIENT_RESOURCES	Los recursos insuficientes están disponibles para realizar la operación solicitada.

Observaciones

El controlador del controlador serie debe llamar a este método desde su EvtDriverDeviceAdd función de devolución de llamada antes de crear un objeto WDFDEVICE para el controlador serie.

SerCx2InitializeDeviceInit adjunta información específica de la extensión a la estructura WDFDEVICE_INIT del controlador. Esta información permite a SerCx2 realizar determinadas acciones en nombre del controlador de controlador serie. Por ejemplo, SerCx2 recibe solicitudes de E/S que los clientes envían al controlador serie.

El controlador del controlador serie debe llamar a serCx2InitializeDeviceInit antes de crear un objeto de dispositivo de marco para representar el controlador serie y antes de llamar al método SerCx2InitializeDevice para terminar de inicializar el objeto de dispositivo. El controlador llama a un método como WdfDeviceCreate para crear el objeto de dispositivo.

SerCx2InitializeDeviceInit establece un descriptor de seguridad predeterminado que permite que los controladores en modo kernel y los controladores en modo de usuario envíen solicitudes de E/S a SerCx2. El descriptor permite que las aplicaciones envíen estas solicitudes solo si se ejecutan con privilegios de administrador. Para especificar este descriptor, SerCx2 usa la siguiente cadena SDDL:

"D:P(A;;GA;;;SY)(A;;GA;;;BA)(A;;GA;;;UD)" Si es necesario, el controlador de controlador serie puede invalidar la configuración predeterminada llamando al método WdfDeviceInitAssignSDDLString con el descriptor de seguridad deseado. El controlador debe llamar a WdfDeviceInitAssignSDDLStr ing después de llamar a SerCx2InitializeDeviceInit pero antes de llamar a WdfDeviceCreate. Para obtener más información sobre las cadenas SDDL, consulte SDDL for Device Objects.