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

Artigo
02/07/2025

A rotina de retorno de chamada digitada PPARALLEL_CLEAR_CHIP_MODElimpa o modo de operação de uma porta paralela redefinindo o modo de comunicação do chipset de host para o modo de compatibilidade do IEEE 1284. O driver de funções fornecido pelo sistema para portas paralelas fornece essa rotina.

Sintaxe

PPARALLEL_CLEAR_CHIP_MODE PparallelClearChipMode;

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

Parâmetros

[in] ClearChipContext

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

[in] ChipMode

Especifica o modo operacional atual da porta paralela.

Para obter mais informações sobre modos operacionais, consulte os modos definidos para o ECR (registro de recursos aprimorado) no arquivo parallel.h incluído no WDK (Microsoft Windows Driver Kit).

Valor de retorno

Código de retorno	Descrição
STATUS_SUCCESS	O modo de operação foi definido como modo de compatibilidade do IEEE 1284.
STATUS_INVALID_DEVICE_STATE	O modo especificado não corresponde ao modo atual.

Observações

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

Um chamador usa o retorno de chamada PPARALLEL_CLEAR_CHIP_MODE em conjunto com o retorno de chamada PPARALLEL_SET_CHIP_MODE.

Para definir um modo, um chamador deve primeiro limpar o modo atual.

Para obter mais informações, consulte Configuração e Desmarcação do Modo de Comunicação em umParallelPort.