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 IRP の完了状態が STATUS_REQUEST_ABORTED されると、すぐに中止します。 これは、デバイスが削除されたか、1394 バスで使用できなくなったことを示します。
状態_* その他のリターン コードは、AV/C プロトコルの範囲外のエラーまたは警告が発生したことを示します。

Comments

この関数は、次に示すように、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 構造体は、PC の外部接続用に DataRanges メンバーに追加されます。

これは IRQL = PASSIVE_LEVELで呼び出す必要があります。

関連項目

AVC_MULTIFUNC_IRB

AVC_PRECONNECT_INFO

AVCPRECONNECTINFO

AVC_FUNCTION