AVC_FUNCTION_SET_CONNECTINFO
AVC_FUNCTION_SET_CONNECT_INFO函数代码为每个引脚 ID 设置 AVCCONNECTINFO 结构, (偏移量从零) 。
I/O 状态块
如果成功,AV/C 协议驱动程序会将 Irp-IoStatus.Status> 设置为STATUS_SUCCESS。
可能的其他返回值包括:
返回值 | 说明 |
---|---|
STATUS_TIMEOUT | 发出了请求,但在所有超时和重试处理完成之前未收到任何响应。 |
STATUS_REQUEST_ABORTED | 当 IRP 完成状态为STATUS_REQUEST_ABORTED时,立即中止。 这表示设备已被移除或不再在 1394 总线上可用。 |
地位_* | 任何其他返回代码指示发生了超出 AV/C 协议范围的错误或警告。 |
注释
此函数使用 AVC_MULTIFUNC_IRB 结构的 SetConnectInfo 成员,如下所示。
typedef struct _AVC_MULTIFUNC_IRB {
AVC_IRB Common;
union {
.
.
.
AVC_SETCONNECT_INFO SetConnectInfo;
.
.
.
};
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;
要求
头: 在 avc.h 中声明 (包括 avc.h)
AVC_MULTIFUNC_IRB输入
通用
此成员的 Function 子成员必须设置为 从 AVC_FUNCTION 枚举AVC_FUNCTION_SET_CONNECTINFO。
SetConnectInfo
指定 AV/C 设备的连接信息。
avc.sys的虚拟实例不支持此函数代码。
如果子单元驱动程序提供相交处理程序,则必须使用此函数。 包含在 AVC_SET_CONNECTINFO 结构中的 AVCCONNECTINFO 结构 (,) 派生自追加到传递给相交处理程序的数据范围中的 AVCPRECONNECTINFO 结构。
确定数据范围兼容后,相交处理程序将生成 AVCCONNECTINFO 结构。 此结构将追加到生成的数据格式中,并发送到 avc.sys。 建议的数据格式稍后是否传递为更好的格式并不重要,因为 avc.sys 只缓存一个 AVCCONNECTINFO 结构。
必须在 IRQL = PASSIVE_LEVEL 调用。