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 함수는 드라이버가 USB 디바이스를 구성 해제할 수 있도록 WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 구조를 초기화합니다.
WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS 함수는 드라이버가 USB 설명자를 사용하여 구성을 지정할 수 있도록 WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 구조를 초기화합니다.
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 함수는 드라이버가 URB를 사용하여 구성을 지정할 수 있도록 WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 구조를 초기화합니다.
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR 함수는 드라이버가 인터페이스 설명자를 지정하여 USB 인터페이스를 선택할 수 있도록 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 구조를 초기화합니다.
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING 함수는 인터페이스 개체에 대한 핸들과 인터페이스에 대한 대체 설정을 지정하여 드라이버가 USB 인터페이스를 선택할 수 있도록 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 구조를 초기화합니다.
WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB 함수는 드라이버가 URB를 지정하여 USB 인터페이스를 선택할 수 있도록 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 구조를 초기화합니다.
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 디바이스 및 설명자 인덱스 값과 연결된 유니코드 문자열을 검색합니다.
WdfUsbTargetDeviceCreate WdfUsbTargetDeviceCreate 메서드는 지정된 프레임워크 디바이스 개체에 대한 프레임워크 USB 디바이스 개체를 만들고 I/O 작업을 위해 USB 디바이스를 엽니다.
WdfUsbTargetDeviceCreateIsochUrb WdfUsbTargetDeviceCreateIsochUrb 메서드는 URB(등시 USB 요청 블록)를 할당합니다.
WdfUsbTargetDeviceCreateUrb WdfUsbTargetDeviceCreateUrb 메서드는 URB(USB 요청 블록)를 할당합니다.
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 디바이스에 대한 USB 디바이스 설명자를 검색합니다.
WdfUsbTargetDeviceGetInterface WdfUsbTargetDeviceGetInterface 메서드는 지정된 인터페이스 인덱스와 연결된 프레임워크 USB 인터페이스 개체에 대한 핸들을 반환합니다.
WdfUsbTargetDeviceGetIoTarget WdfUsbTargetDeviceGetIoTarget 메서드는 지정된 USB 디바이스와 연결된 I/O 대상 개체에 대한 핸들을 반환합니다.
WdfUsbTargetDeviceGetNumInterfaces WdfUsbTargetDeviceGetNumInterfaces 메서드는 지정된 USB 디바이스에서 지원하는 USB 디바이스 인터페이스 수를 반환합니다.
WdfUsbTargetDeviceIsConnectedSynchronous WdfUsbTargetDeviceIsConnectedSynchronous 메서드는 지정된 USB 디바이스가 연결되어 있는지 여부를 결정합니다.
WdfUsbTargetDeviceQueryString WdfUsbTargetDeviceQueryString 메서드는 지정된 USB 디바이스 및 설명자 인덱스 값과 연결된 유니코드 문자열을 검색합니다.
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 WdfUsbTargetPipeWriteSynchronousously 메서드는 쓰기 요청을 빌드하고 지정된 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 인터페이스에 대한 대체 설정을 지정하는 기술을 정의합니다.