WDF_USB_REQUEST_COMPLETION_PARAMS構造体 (wdfusb.h)
[KMDF と UMDF に適用]
WDF_USB_REQUEST_COMPLETION_PARAMS 構造体には、USB デバイスの I/O 要求の完了に関連付けられているパラメーターが含まれています。
構文
typedef struct _WDF_USB_REQUEST_COMPLETION_PARAMS {
USBD_STATUS UsbdStatus;
WDF_USB_REQUEST_TYPE Type;
union {
struct {
WDFMEMORY Buffer;
USHORT LangID;
UCHAR StringIndex;
UCHAR RequiredSize;
} DeviceString;
struct {
WDFMEMORY Buffer;
WDF_USB_CONTROL_SETUP_PACKET SetupPacket;
ULONG Length;
} DeviceControlTransfer;
struct {
WDFMEMORY Buffer;
} DeviceUrb;
struct {
WDFMEMORY Buffer;
size_t Length;
size_t Offset;
} PipeWrite;
struct {
WDFMEMORY Buffer;
size_t Length;
size_t Offset;
} PipeRead;
struct {
WDFMEMORY Buffer;
} PipeUrb;
} Parameters;
} WDF_USB_REQUEST_COMPLETION_PARAMS, *PWDF_USB_REQUEST_COMPLETION_PARAMS;
メンバーズ
UsbdStatus
I/O ターゲットから返された USBD_STATUS型指定された状態値。
Type
要求の種類を識別する WDF_USB_REQUEST_TYPE型指定された値。
Parameters
Parameters.DeviceString
Parameters.DeviceString.Buffer
ドライバーが WdfUsbTargetDeviceFormatRequestForString 呼び出した場合、このメンバーには、Unicode 文字列を受け取るメモリ オブジェクトに対するドライバー指定のハンドルが含まれます。
Parameters.DeviceString.LangID
ドライバーが WdfUsbTargetDeviceFormatRequestForString 呼び出した場合、このメンバーにはドライバーが指定した言語識別子が含まれます。
Parameters.DeviceString.StringIndex
ドライバーが WdfUsbTargetDeviceFormatRequestForString 呼び出した場合、このメンバーにはドライバー指定の文字列インデックスが含まれます。
Parameters.DeviceString.RequiredSize
ドライバーがデバイスの Unicode 文字列 を取得 メソッドを呼び出した場合 (WdfUsbTargetDeviceFormatRequestForUrb を除く)、このメンバーには Parameters.DeviceString.Buffer が指定 バッファーの必要なサイズが含まれます。
WdfUsbTargetDeviceFormatRequestForUrb 呼び出されたドライバーは、ハンドルが Parameters.DeviceUrb.Bufferにある URB から必要なサイズ値を取得できます。
Parameters.DeviceControlTransfer
Parameters.DeviceControlTransfer.Buffer
ドライバーが WdfUsbTargetDeviceFormatRequestForControlTransfer 呼び出した場合、このメンバーには、入力または出力データを受け取るメモリ オブジェクトに対するドライバー指定のハンドルが含まれます。
Parameters.DeviceControlTransfer.SetupPacket
ドライバーが WdfUsbTargetDeviceFormatRequestForControlTransfer 呼び出した場合、このメンバーには、ドライバーが指定した WDF_USB_CONTROL_SETUP_PACKET 構造体のアドレスが含まれます。
Parameters.DeviceControlTransfer.Length
ドライバーがコントロール転送 を送信 メソッドを呼び出した場合 (WdfUsbTargetDeviceFormatRequestForUrb を除く)、このメンバーには送受信されたバイト数が含まれます。
WdfUsbTargetDeviceFormatRequestForUrb 呼び出されたドライバーは、ハンドルが parameters.DeviceUrb.Buffer 内にある URB から長さの値取得できます。
Parameters.DeviceUrb
Parameters.DeviceUrb.Buffer
ドライバーが WdfUsbTargetDeviceFormatRequestForUrb 呼び出した場合、このメンバーには、URB 構造体を含むメモリ オブジェクトに対するドライバー指定のハンドルが含まれます。
Parameters.PipeWrite
Parameters.PipeWrite.Buffer
ドライバーが WdfUsbTargetPipeFormatRequestForWrite 呼び出した場合、このメンバーには、パイプに書き込まれたメモリ オブジェクトに対するドライバー指定のハンドルが含まれます。
Parameters.PipeWrite.Length
ドライバーがパイプ に書き込むメソッド を呼び出した場合 (WdfUsbTargetDeviceFormatRequestForUrb を除く)、このメンバーには送信されたバイト数が含まれます。
WdfUsbTargetDeviceFormatRequestForUrb 呼び出されたドライバーが場合は、ハンドルが Parameters.PipeUrb.Buffer 内にある URB から長さの値取得できます。
Parameters.PipeWrite.Offset
ドライバーが WdfUsbTargetPipeFormatRequestForWrite 呼び出した場合、このメンバーにはドライバーが指定したバッファー オフセットが含まれます。
Parameters.PipeRead
Parameters.PipeRead.Buffer
ドライバーが WdfUsbTargetPipeFormatRequestForRead 呼び出した場合、このメンバーには、パイプから読み取られたデータを含むメモリ オブジェクトに対するドライバー指定のハンドルが含まれます。
Parameters.PipeRead.Length
ドライバーがパイプから読み取 メソッドを呼び出 コントロール転送を送信した場合 (WdfUsbTargetDeviceFormatRequestForUrb を除く)、このメンバーには受信したバイト数が含まれます。
WdfUsbTargetDeviceFormatRequestForUrb 呼び出されたドライバーが場合は、ハンドルが Parameters.PipeUrb.Buffer 内にある URB から長さの値取得できます。
Parameters.PipeRead.Offset
ドライバーが WdfUsbTargetPipeFormatRequestForRead 呼び出した場合、このメンバーにはドライバーが指定したバッファー オフセットが含まれます。
Parameters.PipeUrb
Parameters.PipeUrb.Buffer
ドライバーが WdfUsbTargetPipeFormatRequestForUrb 呼び出した場合、このメンバーには、URB 構造体を含むメモリ オブジェクトに対するドライバー指定のハンドルが含まれます。
備考
WDF_USB_REQUEST_COMPLETION_PARAMS 構造体は、WDF_REQUEST_COMPLETION_PARAMS 構造体のメンバーです。
必要条件
| 要件 | 価値 |
|---|---|
| 最小 KMDF バージョン | 1.0 |
| UMDF の最小バージョン を する | 2.0 |
| ヘッダー | wdfusb.h (Wdfusb.h を含む) |