PPARALLEL_SET_CHIP_MODE回调函数（parallel.h）

2025-02-07

PPARALLEL_SET_CHIP_MODE类型回调例程设置并行端口的作模式。并行端口的系统提供的函数驱动程序提供此例程。

语法

PPARALLEL_SET_CHIP_MODE PparallelSetChipMode;

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

参数

[in] SetChipContext

指向并行端口功能设备对象的设备扩展的指针（FDO）。

[in] ChipMode

指定并行端口的作模式。（有关作模式的详细信息，请参阅 Microsoft Windows 驱动程序工具包 [WDK].].] 中包含的 parallel.h 文件中为增强功能注册（ECR）定义的模式。

返回值

返回代码	描述
STATUS_SUCCESS	已设置指定的作模式。
STATUS_INVALID_DEVICE_STATE	未清除模式。
STATUS_NO_SUCH_DEVICE	指定的作模式无效。

言论

若要获取指向系统提供的 PPARALLEL_SET_CHIP_MODE 回调的指针，内核模式驱动程序使用返回 PARALLEL_PNP_INFORMATION 结构的 IOCTL_INTERNAL_GET_PARALLEL_PNP_INFO 请求。 PARALLEL_PNP_INFORMATION结构的 TrySetChipMode 成员是指向此回调的指针。

调用方将 PPARALLEL_SET_CHIP_MODE 回调与 PPARALLEL_CLEAR_CHIP_MODE 回调结合使用。

若要设置新模式，调用方必须首先清除当前模式。

有关详细信息，请参阅并行端口上设置和清除通信模式。