WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS関数 (wdfusb.h)

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

1. WDF_USB_CONTROL_SETUP_PACKET 構造体を 0 にします。
2. Packet.bm.Request.Type メンバーを BmRequestStandardに設定します。
3. Packet.bm.Request.Dir メンバーを BmRequestDeviceToHost 設定します。
4. Packet.bRequest メンバーを "get status" 要求値に設定します。
5. Packet.wValue.Value メンバーを 0 に設定します。
6. 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
ヘッダー	wdfusb.h (Wdfusb.h を含む)

関連項目

WDF_USB_BMREQUEST_RECIPIENT

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_VENDOR