AVC_FUNCTION_GET_CONNECTINFO
AVC_FUNCTION_GET_CONNECT_INFO函数代码获取每个引脚 ID 的 AVCPRECONNECTINFO 结构, (偏移量从零) 。
I/O 状态块
如果成功,AV/C 协议驱动程序会将 Irp-IoStatus.Status> 设置为 STATUS_SUCCESS。
可能的其他返回值包括:
返回值 | 说明 |
---|---|
STATUS_TIMEOUT | 发出请求,但在所有超时和重试处理完成之前未收到任何响应。 |
STATUS_REQUEST_ABORTED | STATUS_REQUEST_ABORTED IRP 完成状态时立即中止。 这表示设备已被删除或不再在 1394 总线上可用。 |
地位_* | 任何其他返回代码指示发生了超出 AV/C 协议范围的错误或警告。 |
注释
此函数使用 AVC_MULTIFUNC_IRB 结构的 PreConnectInfo 成员,如下所示。
typedef struct _AVC_MULTIFUNC_IRB {
AVC_IRB Common;
union {
.
.
.
AVC_PRECONNECT_INFO PreConnectInfo;
.
.
.
};
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;
AVC_PRECONNECT_INFO 结构的成员如下所示:
typedef struct _AVC_PRECONNECT_INFO {
IN ULONG PinId
OUT AVCPRECONNECTINFO ConnectInfo;
} AVC_PRECONNECT_INFO, *PAVC_PRECONNECT_INFO;
要求
头: 在 avc.h 中声明。 包括 avc.h。
AVC_MULTIFUNC_IRB输入
通用
必须将此成员的 Function 子成员设置为 从AVC_FUNCTION 枚举AVC_FUNCTION_GET_CONNECTINFO。
ConnectInfo
指定 AV/C 设备的连接信息。
avc.sys的虚拟实例不支持此函数代码。
如果子单位驱动程序负责创建KSPIN_DESCRIPTOR结构中包含的数据范围,则必须使用此函数。 AVCPRECONNECTINFO 结构追加到 DataRanges 成员,以便连接到电脑外部。
必须在 IRQL = PASSIVE_LEVEL 调用。