AVC_FUNCTION_GET_CONNECTINFO
AVC_FUNCTION_GET_CONNECT_INFO函式程式碼會取得每個針腳識別碼的 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呼叫。