WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS関数 (wdfusb.h)

[アーティクル]
03/05/2024

[KMDF と UMDF に適用]

WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS関数は、デバイスクラス固有の USB コントロール転送のWDF_USB_CONTROL_SETUP_PACKET構造体を初期化します。

構文

void WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS(
  [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_CLASS関数は次の処理を行います。

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

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_CLASS(
                                        &packet,
                                        BMREQUEST_HOST_TO_DEVICE,
                                        BMREQUEST_TO_DEVICE,
                                        0,
                                        0,
                                        0
                                        );

要件

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