WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 関数 (wdfusb.h)

[KMDF と UMDF に適用]

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck メソッドは、ドライバーの読み取りバッファーのサイズが USB パイプの最大パケット サイズの倍数であるかどうかを示すフレームワークのテストを無効にします。

構文

void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
  [in] WDFUSBPIPE Pipe
);

パラメーター

[in] Pipe

WdfUsbInterfaceGetConfiguredPipe 呼び出すことによって取得されたフレームワーク パイプ オブジェクトへのハンドル。

戻り値

何一つ

備考

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

予期しないバス アクティビティ (babble と呼ばれることもあります) から余分なデータを受信しないように、ドライバーは通常、パイプの最大パケット サイズの倍数である読み取りバッファーを指定します。 (ドライバーは、WDF_USB_PIPE_INFORMATION 構造で USB パイプの最大パケット サイズを受け取ります。既定では、ドライバーがパイプの最大パケット サイズの倍数ではない読み取りバッファーを指定した場合、フレームワークはエラーを報告します。 ドライバーが WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 呼び出した場合、読み取りバッファーが最大パケット サイズの倍数でない場合、フレームワークはエラーを報告しません。

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck メソッドと USB I/O ターゲットの詳細については、「USB I/O ターゲット」を参照してください。

次のコード例では、バッファーのサイズが USB パイプの最大パケット サイズの倍数であるかどうかを示すフレームワークのテストを無効にします。

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
 

必要条件

要件 価値
ターゲット プラットフォーム 万国
最小 KMDF バージョン 1.0
UMDF の最小バージョン する 2.0
ヘッダー wdfusb.h (Wdfusb.h を含む)
ライブラリ Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 する DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExp usbKmdfIrql(kmdf) , usbKmdfIrql2(kmdf) , UsbKmdfIrqlExplicit(kmdf)

関連項目

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetConfiguredPipe