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 调用。

另请参阅

AVC_MULTIFUNC_IRB

AVC_PRECONNECT_INFO

AVCPRECONNECTINFO

AVC_FUNCTION