usb.h) _URB_CONTROL_FEATURE_REQUEST 結構 (
USB 用戶端驅動程式會使用 _URB_CONTROL_FEATURE_REQUEST 結構來設定或清除裝置、介面或連接點上的功能。
語法
struct _URB_CONTROL_FEATURE_REQUEST {
struct _URB_HEADER Hdr;
PVOID Reserved;
ULONG Reserved2;
ULONG Reserved3;
PVOID Reserved4;
PMDL Reserved5;
struct _URB *UrbLink;
struct _URB_HCD_AREA hca;
USHORT Reserved0;
USHORT FeatureSelector;
USHORT Index;
USHORT Reserved1;
};
成員
Hdr
指定 URB 標頭資訊的 _URB_HEADER 結構的指標。 Hdr.Function 表示在裝置、介面、端點或其他非標準元件上執行的集合或清除功能作業。 Hdr.Function 必須具有下列其中一個值：
Hdr.Length 必須等於 sizeof(_URB_CONTROL_FEATURE_REQUEST)。
Reserved
保留的。 請勿使用。
Reserved2
保留的。 請勿使用。
Reserved3
保留的。 請勿使用。
Reserved4
保留的。 請勿使用。
Reserved5
保留的。 請勿使用。
UrbLink
保留的。 請勿使用。
hca
保留的。 請勿使用。
Reserved0
保留的。 請勿使用。
FeatureSelector
指定要清除或設定的 USB 定義功能程式代碼。 使用無效、無法設定或無法清除的功能程式代碼會導致目標停止。 總線驅動程式會將 FeatureSelector 成員中的值複製到安裝封包的 wValue 字段。
Index
如果要求適用於端點或介面，則指定由成功組態要求傳回的裝置定義索引。 否則， Index 必須是零。 總線驅動程式會將 Index 成員中的值複製到安裝封包的 wIndex 欄位。
Reserved1
保留的。 請勿使用。
備註
驅動程式可以使用 UsbBuildFeatureRequest 服務例程來格式化此 URB。
此結構的保留成員必須視為不透明，並保留供系統使用。
當驅動程式使用IRP_MN_WAIT_WAKE要求將USB裝置用於遠端喚醒時，USB 總線驅動程式會自動在裝置上設定遠端喚醒功能。 不需要控件功能 URB。
同樣地，當驅動程式向管道發出函式類型為 URB_FUNCTION_SYNC_RESET_PIPE_AND_CLEAR_STALL 的 URB 時，總線驅動程式會自動清除管道的端點停止功能。 驅動程式不需要將控制功能 URB 傳送至管道，即可清除端點停止。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | usb.h (包含 Usb.h) |