AVC_FUNCTION_SET_CONNECTINFO
AVC_FUNCTION_SET_CONNECT_INFO函式程式碼會設定每個針腳識別碼的 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 的虛擬 實例不支援此函式程式碼。
如果子單位驅動程式提供交集處理常式,則必須使用此函式。 AVCCONNECTINFO 結構 (包含在AVC_SET_CONNECTINFO結構內,) 衍生自附加至傳遞至交集處理常式之資料範圍的資料範圍 AVCPRECONNECTINFO 結構。
判斷資料範圍相容之後,交集處理常式會產生 AVCCONNECTINFO 結構。 這個結構會附加至產生的資料格式,也會傳送至 avc.sys。 因為 avc.sys 只會快取一個 AVCCONNECTINFO 結構,所以建議的資料格式在稍後會向上傳遞,所以並不重要。
這必須在 IRQL = PASSIVE_LEVEL呼叫。