WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS関数 (wdfusb.h)

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

[KMDF と UMDF に適用]

WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS関数は、デバイスの状態を取得する USB コントロール転送のWDF_USB_CONTROL_SETUP_PACKET構造体を初期化します。

構文

void WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS(
  [out] PWDF_USB_CONTROL_SETUP_PACKET Packet,
  [in]  WDF_USB_BMREQUEST_RECIPIENT   BmRequestRecipient,
  [in]  USHORT                        Index
);

パラメーター

[out] Packet

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

[in] BmRequestRecipient

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

[in] Index

WDF_USB_CONTROL_SETUP_PACKET構造体の Packet.wIndex.Value メンバーに格納されている状態インデックス値。

戻り値

なし

解説

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

WDF_USB_CONTROL_SETUP_PACKET構造体をゼロにします。
Packet.bm.Request.Type メンバーを BmRequestStandard に設定します。
Packet.bm.Request.Dir メンバーを BmRequestDeviceToHost に設定します。
Packet.bRequest メンバーを "get status" 要求値に設定します。
Packet.wValue.Value メンバーを 0 に設定します。
Packet->Packet.wIndex.Value メンバーを Index 引数に設定します。

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_GET_STATUS(
                                             &packet,
                                             BmRequestToDevice,
                                             0
                                             );

要件

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