WDF_USB_CONTROL_SETUP_PACKET_INIT関数 (wdfusb.h)

[アーティクル]
02/27/2024

[KMDF と UMDF に適用]

WDF_USB_CONTROL_SETUP_PACKET_INIT関数は、標準の USB コントロール転送のWDF_USB_CONTROL_SETUP_PACKET構造体を初期化します。

構文

void WDF_USB_CONTROL_SETUP_PACKET_INIT(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_DIRECTION   Direction,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   Recipient,
  [in]  BYTE                          Request,
  [in]  USHORT                        Value,
  [in]  USHORT                        Index
);

パラメーター

[out] Packet

WDF_USB_CONTROL_SETUP_PACKET構造体へのポインター。

[in] Direction

WDF_USB_CONTROL_SETUP_PACKET構造体の Packet.bm.Request.Dir メンバーに格納されるWDF_USB_BMREQUEST_DIRECTION型指定された値。

[in] Recipient

WDF_USB_CONTROL_SETUP_PACKET構造体の Packet.bm.Request.Recipient メンバーに格納されるWDF_USB_BMREQUEST_RECIPIENT型指定された値。

[in] Request

WDF_USB_CONTROL_SETUP_PACKET構造体の Packet.bRequest メンバーに格納される要求の種類の定数。

[in] Value

WDF_USB_CONTROL_SETUP_PACKET構造体の Packet.wValue.Value メンバーに格納される要求固有の値。

[in] Index

WDF_USB_CONTROL_SETUP_PACKET構造体の Packet.wIndex.Value メンバーに格納される要求固有のインデックス値。

戻り値

なし

解説

WDF_USB_CONTROL_SETUP_PACKET_INIT関数は次の処理を行います。

WDF_USB_CONTROL_SETUP_PACKET構造体をゼロにします。
Packet.bm.Request.Type メンバーを BmRequestStandard に設定します。
WDF_USB_CONTROL_SETUP_PACKET_INIT関数の入力引数を使用して、他の構造体メンバーを設定します。

WDF_USB_CONTROL_SETUP_PACKET構造体を初期化するには、ドライバーは次のいずれかの関数を呼び出す必要があります。

WDF_USB_CONTROL_SETUP_PACKET_INIT
WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS
WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE
WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS
WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR

例

次のコード例では、 WDF_USB_CONTROL_SETUP_PACKET 構造体を初期化します。

WDF_USB_CONTROL_SETUP_PACKET  packet;

WDF_USB_CONTROL_SETUP_PACKET_INIT(
                                  &packet,
                                  BMREQUEST_HOST_TO_DEVICE,
                                  BMREQUEST_TO_DEVICE,
                                  0,
                                  0,
                                  0
                                  );

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	wdfusb.h (Wdfusb.h を含む)