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

Artículo
02/26/2024

La rutina de devolución de llamada con tipo PPARALLEL_CLEAR_CHIP_MODE borra el modo de funcionamiento de un puerto paralelo restableciendo el modo de comunicación del conjunto de chips host al modo de compatibilidad IEEE 1284. El controlador de función proporcionado por el sistema para puertos paralelos proporciona esta rutina.

Sintaxis

PPARALLEL_CLEAR_CHIP_MODE PparallelClearChipMode;

NTSTATUS PparallelClearChipMode(
  [in] PVOID ClearChipContext,
  [in] UCHAR ChipMode
)
{...}

Parámetros

[in] ClearChipContext

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

[in] ChipMode

Especifica el modo de funcionamiento actual del puerto paralelo.

Para obtener más información sobre los modos operativos, 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	El modo de funcionamiento se estableció en el modo de compatibilidad IEEE 1284.
STATUS_INVALID_DEVICE_STATE	El modo especificado no coincide con el modo actual.

Comentarios

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

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

Para establecer un 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.