PUSB_BUSIFFN_QUERY_BUS_INFORMATION コールバック関数 (usbbusif.h)

QueryBusInformation ルーチンは、バスに関する情報を取得します。

構文

typedef NTSTATUS
  (USB_BUSIFFN *PUSB_BUSIFFN_QUERY_BUS_INFORMATION) (
    IN PVOID,
    IN ULONG,
    IN OUT PVOID,
    IN OUT PULONG,
    OUT PULONG
  );

パラメーター

[in] unnamedParam1

IRP_MN_QUERY_INTERFACE要求によってUSB_BUS_INTERFACE_USBDI_V0構造体の BusContext メンバーで返されるハンドル。

[out, optional] unnamedParam2

出力データの長さを指定します。

[in, out] unnamedParam3

要求されたバス情報を受信するバッファーへのポインター。

[out] unnamedParam4

入力時に、 BusInformationBuffer で指定されたバッファーの長さ。 出力時の出力データの長さ。

[in] unnamedParam5

返される情報のレベルを指定します。 Level が 0 の場合、関数は合計帯域幅と合計消費帯域幅を 1 秒あたりのビット数で返します。 Level が 1 の場合、関数は、合計帯域幅と合計消費帯域幅に加えて、Unicode でコントローラーのシンボリック名を返します。

戻り値

QueryBusInformation は、次のいずれかの値を返します。

リターン コード	説明
STATUS_SUCCESS	呼び出しは、正常に完了しました。
STATUS_BUFFER_TOO_SMALL	バッファーが小さすぎます。 このエラー コードは、次の 2 つのケース で返されます。 Level == 0 の場合は常に、 BusInformationBuffer が指すバッファーのサイズが USB_BUS_INFORMATION_LEVEL_0 構造体のサイズより小さい場合に、このエラー コードが返されます。 Level == 1 の場合は常に、 BusInformationBuffer が指すバッファーのサイズが USB_BUS_INFORMATION_LEVEL_1 構造体のサイズより小さい場合、このエラー コードが返されます。

注釈

このルーチンによって返される正確な情報は、 Level パラメーターの値によって異なります。 このルーチンは、usbd.sys によって提供 されるUSBD_QueryBusInformation ライブラリ関数を置き換えます。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	usbbusif.h (Usbbusif.h を含む)
IRQL	< = DISPATCH_LEVEL

こちらもご覧ください

• USB_BUS_INFORMATION_LEVEL_0
• USB_BUS_INFORMATION_LEVEL_1
• USB_BUS_INTERFACE_USBDI_V0