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

Artículo
02/26/2024

La rutina de devolución de llamada con tipo PPARALLEL_DESELECT_ROUTINE anula la selección de un dispositivo de cadena de margarita IEEE 1284.3 o un dispositivo de extremo de cadena IEEE 1284 que está conectado a un puerto paralelo. El controlador de función proporcionado por el sistema para puertos paralelos proporciona esta rutina.

Sintaxis

PPARALLEL_DESELECT_ROUTINE PparallelDeselectRoutine;

NTSTATUS PparallelDeselectRoutine(
  [in] PVOID DeselectContext,
  [in] PVOID DeselectCommand
)
{...}

Parámetros

[in] DeselectContext

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

[in] DeselectCommand

Puntero a una estructura de PARALLEL_1284_COMMAND. El autor de la llamada especifica los siguientes miembros:

ID

Especifica el identificador de dispositivo 1284.3 (cero o 1).

CommandFlags

Especifica un OR bit a bit de cero o más de las marcas siguientes:

Valor	Descripción
PAR_END_OF_CHAIN_DEVICE	Especifica un dispositivo de extremo de cadena.
PAR_HAVE_PORT_KEEP_PORT	Especifica que el puerto se mantiene asignado.

Valor devuelto

Código devuelto	Descripción
STATUS_SUCCESS	El dispositivo se deseleccionó.
STATUS_INVALID_PARAMETER	El identificador de dispositivo especificado no es válido.
STATUS_UNSUCCESSFUL	El controlador de función proporcionado por el sistema para los puertos paralelos no pudo anular la selección del dispositivo.

Comentarios

Para obtener un puntero a la devolución de llamada proporcionada por el sistema PPARALLEL_DESELECT_ROUTINE , 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 DeselectDevice de la estructura PARALLEL_PNP_INFORMATION es un puntero a esta devolución de llamada.

Un controlador en modo kernel puede usar una solicitud de IOCTL_INTERNAL_DESELECT_DEVICE o la devolución de llamada PPARALLEL_CLEAR_CHIP_MODE para anular la selección de un dispositivo en un puerto paralelo representado por un puerto paralelo. Para anular la selección de un dispositivo, un llamador debe tener asignado el puerto paralelo. Si el autor de la llamada no establece la marca de PAR_HAVE_PORT_KEEP_PORT, el controlador de función proporcionado por el sistema para puertos paralelos libera el puerto paralelo después de anular la selección del dispositivo.

Para obtener más información, consulte Selección y deselección de un dispositivo IEEE 1284 conectado a parallelPort.