PPARALLEL_SET_CHIP_MODE función de devolución de llamada (parallel.h)

Artículo
03/05/2024

La rutina de devolución de llamada con tipo PPARALLEL_SET_CHIP_MODE establece el modo de funcionamiento de un puerto paralelo. El controlador de función proporcionado por el sistema para puertos paralelos proporciona esta rutina.

Sintaxis

PPARALLEL_SET_CHIP_MODE PparallelSetChipMode;

NTSTATUS PparallelSetChipMode(
  [in] PVOID SetChipContext,
  [in] UCHAR ChipMode
)
{...}

Parámetros

[in] SetChipContext

Puntero a la extensión de dispositivo de un objeto de dispositivo funcional (FDO) de un puerto paralelo.

[in] ChipMode

Especifica el modo de funcionamiento de un puerto paralelo. (Para obtener más información sobre los modos de funcionamiento, vea los modos definidos para el registro de funcionalidades mejoradas (ECR) en el archivo parallel.h que se incluye en el Kit de controladores de Microsoft Windows [WDK].)

Valor devuelto

Código devuelto	Descripción
STATUS_SUCCESS	Se estableció el modo de funcionamiento especificado.
STATUS_INVALID_DEVICE_STATE	El modo no está desactivado.
STATUS_NO_SUCH_DEVICE	El modo de funcionamiento especificado no es válido.

Comentarios

Para obtener un puntero a la devolución de llamada PPARALLEL_SET_CHIP_MODE proporcionada por el sistema, un controlador en modo kernel usa una solicitud de IOCTL_INTERNAL_GET_PARALLEL_PNP_INFO , que devuelve una estructura de PARALLEL_PNP_INFORMATION . El miembro TrySetChipMode de la estructura PARALLEL_PNP_INFORMATION es un puntero a esta devolución de llamada.

Un llamador usa la devolución de llamada PPARALLEL_SET_CHIP_MODE junto con la devolución de llamada PPARALLEL_CLEAR_CHIP_MODE .

Para establecer un nuevo modo, un llamador debe borrar primero el modo actual.

Para obtener más información, vea Establecer y borrar el modo de comunicación en parallelPort.