AVCSTRM_READ
AVCSTRM_READ函数代码用于提交使用指定流中的数据填充的数据缓冲区avcstrm.sys。
如果成功, avcstrm.sys将 Irp-IoStatus.Status> 设置为 STATUS_SUCCESS。
可能的错误返回值包括:
错误状态 | 说明 |
---|---|
STATUS_DEVICE_REMOVED | 与 AVCSTRM_READ 操作对应的设备不再存在。 |
STATUS_CANCELLED | 请求无法完成。 |
STATUS_INVALID_PARAMETER | IRP 中指定的参数不正确, |
STATUS_INSUFFICIENT_RESOURCES | 没有足够的系统资源来完成请求。 |
STATUS_PENDING | 已收到请求,但需要进一步处理。 I/O 完成例程将处理最终响应。 |
SizeOfThisBlock、版本和函数
使用 INIT_AVCSTRM_HEADER 宏初始化这些成员。 在宏的 Request 参数中传递 AVCSTRM_READ 。
AVCStreamContext
指定流上下文 (句柄) 由作为读取操作数据源的早期 AVCSTRM_OPEN 调用返回。
BufferStruct
指定读取操作应将数据放入的缓冲区。
子单元驱动程序必须先分配 IRP 和 AVC_STREAM_REQUEST_BLOCK 结构。
接下来,它应使用 INIT_AVCSTRM_HEADER 宏初始化AVC_STREAM_REQUEST_BLOCK结构,并将 AVCSTRM_READ 作为 Request 参数传递给宏。
接下来,子单位驱动程序将 AVCStreamContext 成员设置为流上下文, (处理提供要读取的数据的流) 。 最后,子单位驱动程序设置 CommandData 联合的 BufferStruct 成员,该成员描述读取操作将数据放入的缓冲区。
若要发送此请求,子单元提交 一个IRP_MJ_INTERNAL_DEVICE_CONTROL IRP,其中 IRP 的 IoControlCode 成员设置为 IOCTL_AVCSTRM_CLASS ,IRP 的 Argument1 成员设置为描述要执行的读取操作的AVC_STREAM_REQUEST_BLOCK结构。
此命令以异步方式完成。 完成后,将调用 IRP 中设置的 I/O 完成例程。
必须在 IRQL = PASSIVE_LEVEL 调用此函数代码。
此函数在 AVC_STREAM_REQUEST_BLOCK 结构中使用 CommandData 联合的 BufferStruct 成员,如下所示。
typedef struct _AVC_STREAM_REQUEST_BLOCK {
ULONG SizeOfThisBlock;
ULONG Version;
AVCSTRM_FUNCTION Function;
.
.
PVOID AVCStreamContext;
.
.
union _tagCommandData {
.
.
AVCSTRM_BUFFER_STRUCT BufferStruct;
.
.
} CommandData;
} AVC_STREAM_REQUEST_BLOCK, *PAVC_STREAM_REQUEST_BLOCK;
头: 在 avcstrm.h 中声明。 包括 avcstrm.h。