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 プロトコルの範囲外のエラーまたは警告が発生したことを示します。 |
Comments
この関数は、次に示すように、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 は 1 つの AVCCONNECTINFO 構造体のみをキャッシュするため、提案されたデータ形式が後で適切な形式に渡されるかどうかは関係ありません。
これは IRQL = PASSIVE_LEVELで呼び出す必要があります。