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

Artigo
02/29/2024

A rotina de retorno de chamada com tipo PPARALLEL_SET_CHIP_MODE define o modo de operação de uma porta paralela. O driver de função fornecido pelo sistema para portas paralelas fornece essa rotina.

Sintaxe

PPARALLEL_SET_CHIP_MODE PparallelSetChipMode;

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

Parâmetros

[in] SetChipContext

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

[in] ChipMode

Especifica o modo de operação de uma porta paralela. (Para obter mais informações sobre modos de operação, consulte os modos definidos para o ECR (registro de recursos aprimorados) no arquivo parallel.h incluído no Microsoft Windows Driver Kit [WDK].)

Retornar valor

Código de retorno	Descrição
STATUS_SUCCESS	O modo de operação especificado foi definido.
STATUS_INVALID_DEVICE_STATE	O modo não está limpo.
STATUS_NO_SUCH_DEVICE	O modo de operação especificado não é válido.

Comentários

Para obter um ponteiro para o retorno de chamada PPARALLEL_SET_CHIP_MODE 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 TrySetChipMode da estrutura PARALLEL_PNP_INFORMATION é um ponteiro para esse retorno de chamada.

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

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

Para obter mais informações, consulte Configurando e limpando o modo de comunicação em um ParallelPort.