PPARALLEL_WRITE回调函数 （parallel.h）

PPARALLEL_WRITE类型的回调例程将数据写入并行设备。 并行端口的系统提供的总线驱动程序提供此例程。

语法

PPARALLEL_WRITE PparallelWrite;

NTSTATUS PparallelWrite(
  [in]  PVOID Context,
  [in]  PVOID Buffer,
  [in]  ULONG NumBytesToWrite,
  [out] PULONG NumBytesWritten,
  [in]  UCHAR Channel
)
{...}

参数

[in] Context

指向并行设备物理设备对象的设备扩展（PDO）的指针。

[in] Buffer

指向调用方分配的写入缓冲区的指针。

[in] NumBytesToWrite

指定要从写入缓冲区复制到并行设备的字节数。 必须小于或等于调用方分配的写入缓冲区中的字节数。

[out] NumBytesWritten

指定实际从调用方分配的写入缓冲区复制到并行设备的字节数。

[in] Channel

未使用。

返回值

返回代码	描述
STATUS_SUCCESS	调用方提供的数据已成功传输到设备。
STATUS_Xxx	内部作导致 NTSTATUS 错误。

言论

若要获取指向系统提供的PPARALLEL_WRITE回调的指针，内核模式驱动程序使用 IOCTL_INTERNAL_PARCLASS_CONNECT 请求，该请求返回 PARCLASS_INFORMATION 结构。 PARCLASS_INFORMATION结构的 ParallelWrite 成员是指向此回调的指针。

仅当客户端在并行端口上具有锁时，客户端才能使用此例程。 客户端使用 IOCTL_INTERNAL_LOCK_PORT 请求获取并行端口上的锁。

PPARALLEL_WRITE回调在调用方 IRQL 的调用方线程中运行。

要求

要求	价值
目标平台	桌面
标头	parallel.h （include Parallel.h）

另请参阅

PPARALLEL_READ

IOCTL_INTERNAL_LOCK_PORT