wdfusb.h 標頭

wdf 會使用此標頭。 如需詳細資訊，請參閱

• Windows 驅動程式架構

wdfusb.h 包含下列程式設計介面：

函式

WDF_USB_CONTINUOUS_READER_CONFIG_INIT WDF_USB_CONTINUOUS_READER_CONFIG_INIT函式會初始化WDF_USB_CONTINUOUS_READER_CONFIG結構。
WDF_USB_CONTROL_SETUP_PACKET_INIT WDF_USB_CONTROL_SETUP_PACKET_INIT函式會初始化標準 USB 控制項傳輸的WDF_USB_CONTROL_SETUP_PACKET結構。
WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS函式會初始化裝置類別特定 USB 控制傳輸的WDF_USB_CONTROL_SETUP_PACKET結構。
WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE函式會針對設定或清除裝置功能的 USB 控制項傳輸，初始化 WDF_USB_CONTROL_SETUP_PACKET 結構。
WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS函式會針對取得裝置狀態的 USB 控制項傳輸，初始化WDF_USB_CONTROL_SETUP_PACKET結構。
WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR函式會初始化廠商特定 USB 控制傳輸的WDF_USB_CONTROL_SETUP_PACKET結構。
WDF_USB_DEVICE_CREATE_CONFIG_INIT WDF_USB_DEVICE_CREATE_CONFIG_INIT函式會初始化WDF_USB_DEVICE_CREATE_CONFIG結構。
WDF_USB_DEVICE_INFORMATION_INIT WDF_USB_DEVICE_INFORMATION_INIT函式會初始化驅動程式的WDF_USB_DEVICE_INFORMATION結構。
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG函式會初始化WDF_USB_DEVICE_SELECT_CONFIG_PARAMS結構，讓驅動程式可以取消設定 USB 裝置。
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS函式會初始化WDF_USB_DEVICE_SELECT_CONFIG_PARAMS結構，讓驅動程式可以使用 USB 描述元來指定設定。
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES函式會初始化WDF_USB_DEVICE_SELECT_CONFIG_PARAMS結構，讓驅動程式可以將裝置設定為使用多個介面。
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE函式會初始化WDF_USB_DEVICE_SELECT_CONFIG_PARAMS結構，讓驅動程式可以設定裝置使用單一指定的介面。
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB函式會初始化 WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 結構，讓驅動程式可以使用 URB 來指定設定。
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR函式會初始化WDF_USB_INTERFACE_SELECT_SETTING_PARAMS結構，讓驅動程式可以藉由指定介面描述元來選取 USB 介面。
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING函式會初始化WDF_USB_INTERFACE_SELECT_SETTING_PARAMS結構，讓驅動程式可以藉由指定介面物件的控制碼和介面的替代設定，來選取 USB 介面。
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB函式會初始化WDF_USB_INTERFACE_SELECT_SETTING_PARAMS結構，讓驅動程式可以藉由指定 URB 來選取 USB 介面。
WDF_USB_PIPE_DIRECTION_IN WDF_USB_PIPE_DIRECTION_IN函式會判斷指定的 USB 端點是否為輸入端點。
WDF_USB_PIPE_DIRECTION_OUT WDF_USB_PIPE_DIRECTION_OUT函式會判斷指定的 USB 端點是否為輸出端點。
WDF_USB_PIPE_INFORMATION_INIT WDF_USB_PIPE_INFORMATION_INIT函式會初始化WDF_USB_PIPE_INFORMATION結構。
WdfUsbInterfaceGetConfiguredPipe WdfUsbInterfaceGetConfiguredPipe 方法會傳回與指定 USB 裝置介面和管道索引相關聯的架構管道物件控制碼。 或者，方法也會傳回管道的相關資訊。
WdfUsbInterfaceGetConfiguredSettingIndex WdfUsbInterfaceGetConfiguredSettingIndex 方法會傳回目前為指定 USB 裝置介面選取的替代設定索引。
WdfUsbInterfaceGetDescriptor WdfUsbInterfaceGetDescriptor 方法會擷取與指定 USB 介面之指定替代設定相關聯的 USB 介面描述元。
WdfUsbInterfaceGetEndpointInformation WdfUsbInterfaceGetEndpointInformation 方法會擷取指定 USB 裝置端點及其相關聯管道的相關資訊。
WdfUsbInterfaceGetInterfaceNumber WdfUsbInterfaceGetInterfaceNumber 方法會傳回指定之 USB 介面物件的介面編號。
WdfUsbInterfaceGetNumConfiguredPipes WdfUsbInterfaceGetNumConfiguredPipes 方法會傳回為指定 USB 裝置介面所設定的管道數目。
WdfUsbInterfaceGetNumEndpoints WdfUsbInterfaceGetNumEndpoints 方法會傳回與指定 USB 介面之指定替代設定相關聯的端點數目。
WdfUsbInterfaceGetNumSettings WdfUsbInterfaceGetNumSettings 方法會傳回指定 USB 介面支援的替代設定數目。
WdfUsbInterfaceSelectSetting WdfUsbInterfaceSelectSetting 方法會選取指定 USB 介面的指定替代設定。
WdfUsbTargetDeviceAllocAndQueryString WdfUsbTargetDeviceAllocAndQueryString 方法會配置緩衝區，然後擷取與指定 USB 裝置和描述元索引值相關聯的 Unicode 字串。
WdfUsbTargetDeviceCreate WdfUsbTargetDeviceCreate 方法會為指定的架構裝置物件建立架構 USB 裝置物件，並開啟 I/O 作業的 USB 裝置。
WdfUsbTargetDeviceCreateIsochUrb WdfUsbTargetDeviceCreateIsochUrb 方法會配置異時 USB 要求區塊， (URB) 。
WdfUsbTargetDeviceCreateUrb WdfUsbTargetDeviceCreateUrb 方法會配置 USB 要求區塊 (URB) 。
WdfUsbTargetDeviceCreateWithParameters WdfUsbTargetDeviceCreateWithParameters 方法會為指定的架構架構裝置物件建立架構 USB 裝置物件，並開啟 I/O 作業的 USB 裝置。
WdfUsbTargetDeviceCyclePortSynchronously WdfUsbTargetDeviceCyclePortSynchronously 方法會迴圈連接指定裝置的 USB 埠。
WdfUsbTargetDeviceFormatRequestForControlTransfer WdfUsbTargetDeviceFormatRequestForControlTransfer 方法會建置 USB 控制項傳輸要求，但不會傳送要求。
WdfUsbTargetDeviceFormatRequestForCyclePort WdfUsbTargetDeviceFormatRequestForCyclePort 方法會建置所指定裝置所連結之埠的電源迴圈要求，但不會傳送要求。
WdfUsbTargetDeviceFormatRequestForString WdfUsbTargetDeviceFormatRequestForString 方法會建置與 USB 裝置字串索引值相關聯的 USB 字串描述元要求。
WdfUsbTargetDeviceFormatRequestForUrb WdfUsbTargetDeviceFormatRequestForUrb 方法會使用 URB 所描述的要求參數來建置指定 USB 裝置的 USB 要求，但不會傳送要求。
WdfUsbTargetDeviceGetDeviceDescriptor WdfUsbTargetDeviceGetDeviceDescriptor 方法會擷取與指定架構 USB 裝置物件相關聯的 USB 裝置描述元。
WdfUsbTargetDeviceGetInterface WdfUsbTargetDeviceGetInterface 方法會傳回與指定介面索引相關聯的架構 USB 介面物件控制碼。
WdfUsbTargetDeviceGetIoTarget WdfUsbTargetDeviceGetIoTarget 方法會傳回與指定 USB 裝置相關聯的 I/O 目標物件的控制碼。
WdfUsbTargetDeviceGetNumInterfaces WdfUsbTargetDeviceGetNumInterfaces 方法會傳回指定 USB 裝置所支援的 USB 裝置介面數目。
WdfUsbTargetDeviceIsConnectedSynchronous WdfUsbTargetDeviceIsConnectedSynchronous 方法會判斷指定的 USB 裝置是否已連線。
WdfUsbTargetDeviceQueryString WdfUsbTargetDeviceQueryString 方法會擷取與指定 USB 裝置和描述元索引值相關聯的 Unicode 字串。
WdfUsbTargetDeviceQueryUsbCapability WdfUsbTargetDeviceQueryUsbCapability 方法會判斷主機控制器和 USB 驅動程式堆疊是否支援特定功能。
WdfUsbTargetDeviceResetPortSynchronously WdfUsbTargetDeviceResetPortSynchronously 方法會重設與指定之 USB 裝置相關聯的 USB 埠。
WdfUsbTargetDeviceRetrieveConfigDescriptor WdfUsbTargetDeviceRetrieveConfigDescriptor 方法會擷取與指定架構 USB 裝置物件相關聯之 USB 裝置的 USB 組態描述元。
WdfUsbTargetDeviceRetrieveCurrentFrameNumber WdfUsbTargetDeviceRetrieveCurrentFrameNumber 方法會擷取目前的 USB 畫面編號。
WdfUsbTargetDeviceRetrieveInformation WdfUsbTargetDeviceRetrieveInformation 方法會擷取與指定架構 USB 裝置物件相關聯的 USB 裝置相關資訊。
WdfUsbTargetDeviceSelectConfig WdfUsbTargetDeviceSelectConfig 方法會選取裝置的 USB 設定，或取消設定裝置。
WdfUsbTargetDeviceSendControlTransferSynchronously WdfUsbTargetDeviceSendControlTransferSynchronously 方法會建置 USB 控制傳輸要求，並將它同步傳送至 I/O 目標。
WdfUsbTargetDeviceSendUrbSynchronously WdfUsbTargetDeviceSendUrbSynchronously 方法會使用 URB 所描述的要求參數，以同步方式將 USB 要求傳送至指定的 USB 裝置。
WdfUsbTargetDeviceWdmGetConfigurationHandle WdfUsbTargetDeviceWdmGetConfigurationHandle 方法會傳回與指定 USB 裝置目前設定相關聯的USBD_CONFIGURATION_HANDLE型別控制碼。
WdfUsbTargetPipeAbortSynchronously WdfUsbTargetPipeAbortSynchronously 方法會建置中止要求，並以同步方式將它傳送至指定的 USB 管道。
WdfUsbTargetPipeConfigContinuousReader WdfUsbTargetPipeConfigContinuousReader 方法會將架構設定為從指定的 USB 管道持續讀取。
WdfUsbTargetPipeFormatRequestForAbort WdfUsbTargetPipeFormatRequestForAbort 方法會為指定的 USB 管道建置中止要求，但不會傳送要求。
WdfUsbTargetPipeFormatRequestForRead WdfUsbTargetPipeFormatRequestForRead 方法會建置 USB 輸入管道的讀取要求，但不會傳送要求。
WdfUsbTargetPipeFormatRequestForReset WdfUsbTargetPipeFormatRequestForReset 方法會建置指定 USB 管道的重設要求，但不會傳送要求。
WdfUsbTargetPipeFormatRequestForUrb WdfUsbTargetPipeFormatRequestForUrb 方法會使用指定 URB 描述的要求參數來建置指定 USB 管道的 USB 要求，但不會傳送要求。
WdfUsbTargetPipeFormatRequestForWrite WdfUsbTargetPipeFormatRequestForWrite 方法會建置 USB 輸出管道的寫入要求，但不會傳送要求。
WdfUsbTargetPipeGetInformation WdfUsbTargetPipeGetInformation 方法會擷取 USB 管道及其端點的相關資訊。
WdfUsbTargetPipeGetIoTarget WdfUsbTargetPipeGetIoTarget 方法會傳回與指定 USB 管道相關聯的 I/O 目標物件的控制碼。
WdfUsbTargetPipeGetType WdfUsbTargetPipeGetType 方法會傳回指定之 USB 管道的類型。
WdfUsbTargetPipeIsInEndpoint WdfUsbTargetPipeIsInEndpoint 方法會判斷指定的 USB 管道是否連接到輸入端點。
WdfUsbTargetPipeIsOutEndpoint WdfUsbTargetPipeIsOutEndpoint 方法會判斷指定的 USB 管道是否連接到輸出端點。
WdfUsbTargetPipeReadSynchronously WdfUsbTargetPipeReadSynchronously 方法會建置讀取要求，並以同步方式將它傳送至指定的 USB 輸入管道。
WdfUsbTargetPipeResetSynchronously WdfUsbTargetPipeResetSynchronously 方法會建置重設要求，並以同步方式將它傳送至指定的 USB 管道。
WdfUsbTargetPipeSendUrbSynchronously WdfUsbTargetPipeSendUrbSynchronously 方法會使用指定 URB 所描述的要求參數，為指定的 USB 管道建置 USB 要求。
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 方法會停用架構測試驅動程式讀取緩衝區的大小是否為 USB 管道封包大小上限的倍數。
WdfUsbTargetPipeWdmGetPipeHandle WdfUsbTargetPipeWdmGetPipeHandle 方法會傳回與指定之架構管道物件相關聯的USBD_PIPE_HANDLE型別控制碼。
WdfUsbTargetPipeWriteSynchronously WdfUsbTargetPipeWriteSynchronously 方法會建置寫入要求，並以同步方式傳送至指定的 USB 輸出管道。

回呼函式

EVT_WDF_USB_READER_COMPLETION_ROUTINE 驅動程式的 EvtUsbTargetPipeReadComplete 事件回呼函式會通知驅動程式連續讀取器已成功完成讀取要求。
EVT_WDF_USB_READERS_FAILED 驅動程式的 EvtUsbTargetPipeReadersFailed 事件回呼函式會通知驅動程式連續讀取器在處理讀取要求時回報錯誤。

結構

WDF_USB_CONTINUOUS_READER_CONFIG WDF_USB_CONTINUOUS_READER_CONFIG 結構包含架構用來設定 USB 管道連續讀取器的資訊。
WDF_USB_CONTROL_SETUP_PACKET WDF_USB_CONTROL_SETUP_PACKET結構描述 USB 控制傳輸的設定封包。
WDF_USB_DEVICE_CREATE_CONFIG WDF_USB_DEVICE_CREATE_CONFIG 結構包含架構用來設定架構 USB 裝置物件的資訊。
WDF_USB_DEVICE_INFORMATION WDF_USB_DEVICE_INFORMATION 結構包含 USB 裝置的版本和功能資訊。
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS WDF_USB_DEVICE_SELECT_CONFIG_PARAMS結構會指定 USB 裝置組態參數。
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 結構包含 USB 介面的選取資訊。
WDF_USB_INTERFACE_SETTING_PAIR WDF_USB_INTERFACE_SETTING_PAIR 結構會指定指定之 USB 介面的替代設定。
WDF_USB_PIPE_INFORMATION WDF_USB_PIPE_INFORMATION 結構包含 USB 管道及其端點的相關資訊。
WDF_USB_REQUEST_COMPLETION_PARAMS WDF_USB_REQUEST_COMPLETION_PARAMS 結構包含與完成 USB 裝置 I/O 要求相關聯的參數。

列舉

WDF_USB_BMREQUEST_DIRECTION WDF_USB_BMREQUEST_DIRECTION列舉會識別 USB 控制項傳輸的資料傳輸方向。
WDF_USB_BMREQUEST_RECIPIENT WDF_USB_BMREQUEST_RECIPIENT列舉會識別 USB 控制傳輸的資料傳輸收件者。
WDF_USB_BMREQUEST_TYPE WDF_USB_BMREQUEST_TYPE列舉會識別 USB 控制項傳輸的資料傳輸類型。
WDF_USB_DEVICE_TRAITS WDF_USB_DEVICE_TRAITS列舉可識別 USB 裝置特性。
WDF_USB_PIPE_TYPE WDF_USB_PIPE_TYPE列舉會識別 USB 管道的類型。
WDF_USB_REQUEST_TYPE WDF_USB_REQUEST_TYPE列舉會識別架構型驅動程式可以傳送至 USB I/O 目標的 USB 要求類型。
WdfUsbTargetDeviceSelectConfigType WdfUsbTargetDeviceSelectConfigType 列舉會定義 USB 裝置的設定作業類型。
WdfUsbTargetDeviceSelectSettingType WdfUsbTargetDeviceSelectSettingType 列舉會定義指定 USB 介面替代設定的技術。