Función UcmTcpciPortControllerStart (ucmtcpciportcontroller.h)
Indica a la extensión de clase UcmTcpciCx que el controlador cliente ya está listo para atender las solicitudes de hardware para el controlador de puerto.
Sintaxis
NTSTATUS UcmTcpciPortControllerStart(
UCMTCPCIPORTCONTROLLER PortControllerObject
);
Parámetros
PortControllerObject
Identificador del objeto de controlador de puerto que el controlador cliente recibió en la llamada anterior a UcmTcpciPortControllerCreate.
Valor devuelto
(NTSTATUS) El método devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método puede devolver un código de error NTSTATUS adecuado.
| Código devuelto | Descripción |
|---|---|
|
El controlador de puerto ya está en estado Start. |
|
No se ha establecido la cola de solicitudes de hardware llamando a UcmTcpciPortControllerSetHardwareRequestQueue. |
Observaciones
Después de que el controlador cliente haya recibido el identificador UCMPORTCONTROLLER para el objeto de controlador de puerto, el controlador llama a este método para notificar a la extensión de clase que el controlador puede empezar a recibir solicitudes de hardware. Esta llamada al método permite al controlador cliente realizar la inicialización de su espacio de contexto de marco en el objeto de controlador de puerto, antes de que la extensión de clase pueda invocar las funciones de devolución de llamada del controlador o las solicitudes del objeto de controlador de puerto. El controlador no puede llamar a UcmTcpciPortControllerAlert o UcmTcpciPortControllerStop hasta que se haya iniciado el controlador de puerto.
El controlador cliente llama a este método justo después de llamar a UcmTcpciPortControllerCreate e inicializar su estructura de contexto, si se especificó en la estructura de WDF_OBJECT_ATTRIBUTES como el valor de parámetro Atributos. El controlador debe suponer que la extensión de clase puede enviar solicitudes incluso antes de UcmTcpciPortControllerStart devuelve, es decir, desde esta llamada DDI. Si el controlador mantiene un bloqueo al llamar a UcmTcpciPortControllerStart e intenta adquirir un bloqueo al controlar una solicitud de hardware (en su devolución de llamada de cola de solicitudes de hardware), podría provocar un interbloqueo.
Una llamada a UcmTcpciPortControllerStart para iniciar un objeto de controlador de puerto ya en estado Start, produce un error.
Al arrancar, si el BIOS ya había negociado un contrato de PD, UcmTcpciCx comienza desde un estado no conectado.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10 |
| servidor mínimo admitido | Windows Server 2016 |
| de la plataforma de destino de | Windows |
| encabezado de | ucmtcpciportcontroller.h |
| biblioteca de | Ucmtcpcicxstub.lib |
| irQL | PASSIVE_LEVEL |