通过

PPARALLEL_WRITE callback 函数 (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 (包括 Parallel.h)

另请参阅

PPARALLEL_READ

IOCTL_INTERNAL_LOCK_PORT