Función SerCxInitialize (sercx.h)

El método SerCxInitialize completa la inicialización de la extensión de marco serie (SerCx) después de que este controlador cree el objeto de dispositivo asociado.

Sintaxis

NTSTATUS SerCxInitialize(
  [in] WDFDEVICE     FxDevice,
  [in] PSERCX_CONFIG Config
);

Parámetros

[in] FxDevice

Un identificador WDFDEVICE para el objeto de dispositivo de marco que representa el controlador serie.

[in] Config

Puntero a una estructura de SERCX_CONFIG asignada por el autor de la llamada que contiene información de configuración para SerCx. El autor de la llamada anteriormente llamó a la función SERCX_CONFIG_INIT para inicializar esta estructura.

Valor devuelto

serCxInitialize devuelve STATUS_SUCCESS si se ejecuta 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 identificador WDFDEVICE no es válido; o bien FxDevice o Config es NULL.
STATUS_INSUFFICIENT_RESOURCES	No se pudieron asignar recursos del sistema (normalmente memoria).

Observaciones

El controlador de controlador serie llama a este método después de crear el objeto de dispositivo asociado.

SerCxInitialize registra las funciones de devolución de llamada de E/S del controlador con SerCx. Además, este método define el modo de transferencia para la cola de E/S. Durante la llamada, este método crea todas las estructuras internas requeridas por SerCx (incluida la cola de E/S para el controlador serie). Una vez devuelto este método, SerCx está listo para procesar la E/S. Sin embargo, el controlador del controlador puede configurar las opciones de hardware del controlador antes de que vuelva de la EvtDriverDeviceAdd devolución de llamada o antes de agregar el PDO a la lista secundaria.

Si los parámetros no son válidos (como se describe en SERCX_CONFIG), comprobador de controladores generará un error.

Se debe llamar a esta rutina antes de confirmar el dispositivo (volver de EvtDriverDeviceAdd o agregar el PDO a la lista secundaria).

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows 8.
de la plataforma de destino de	Universal
encabezado de	sercx.h
irQL	PASSIVE_LEVEL

Consulte también

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT