PPARALLEL_DESELECT_ROUTINE função de retorno de chamada (parallel.h)

Artigo
02/26/2024

A rotina de retorno de chamada do tipo PPARALLEL_DESELECT_ROUTINE desmarca um dispositivo de cadeia de margaridas IEEE 1284.3 ou um dispositivo de fim de cadeia IEEE 1284 anexado a uma porta paralela. O driver de função fornecido pelo sistema para portas paralelas fornece essa rotina.

Sintaxe

PPARALLEL_DESELECT_ROUTINE PparallelDeselectRoutine;

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

Parâmetros

[in] DeselectContext

Ponteiro para a extensão de dispositivo de um FDO (objeto de dispositivo funcional) que representa uma porta paralela.

[in] DeselectCommand

Ponteiro para uma estrutura PARALLEL_1284_COMMAND. O chamador especifica os seguintes membros:

ID

Especifica a ID do dispositivo 1284.3 (zero ou 1).

CommandFlags

Especifica um OR bit a bit de zero ou mais dos seguintes sinalizadores:

Valor	Descrição
PAR_END_OF_CHAIN_DEVICE	Especifica um dispositivo de fim de cadeia.
PAR_HAVE_PORT_KEEP_PORT	Especifica que a porta seja mantida alocada.

Retornar valor

Código de retorno	Descrição
STATUS_SUCCESS	O dispositivo foi desmarcado.
STATUS_INVALID_PARAMETER	A ID do dispositivo especificada é inválida.
STATUS_UNSUCCESSFUL	O driver de função fornecido pelo sistema para portas paralelas não pôde desmarcar o dispositivo.

Comentários

Para obter um ponteiro para o retorno de chamada PPARALLEL_DESELECT_ROUTINE fornecido pelo sistema, um driver de modo kernel usa uma solicitação de IOCTL_INTERNAL_GET_PARALLEL_PNP_INFO , que retorna uma estrutura PARALLEL_PNP_INFORMATION . O membro DeselectDevice da estrutura PARALLEL_PNP_INFORMATION é um ponteiro para esse retorno de chamada.

Um driver de modo kernel pode usar uma solicitação de IOCTL_INTERNAL_DESELECT_DEVICE ou o retorno de chamada PPARALLEL_CLEAR_CHIP_MODE para desmarcar um dispositivo em uma porta paralela representada por uma porta paralela. Para desmarcar um dispositivo, um chamador deve ter a porta paralela alocada. Se o chamador não definir o sinalizador PAR_HAVE_PORT_KEEP_PORT, o driver de função fornecido pelo sistema para portas paralelas liberará a porta paralela após a desmarcação do dispositivo.

Para obter mais informações, consulte Selecionar e desmarcar um dispositivo IEEE 1284 anexado a um ParallelPort.