WdfUsbTargetPipeResetSynchronousously 함수(wdfusb.h)

[KMDF 및 UMDF에 적용]

WdfUsbTargetPipeResetSynchronously 메서드는 재설정 요청을 빌드하고 지정된 USB 파이프에 동기적으로 보냅니다.

통사론

NTSTATUS WdfUsbTargetPipeResetSynchronously(
  [in]           WDFUSBPIPE                Pipe,
  [in, optional] WDFREQUEST                Request,
  [in, optional] PWDF_REQUEST_SEND_OPTIONS RequestOptions
);

매개 변수

[in] Pipe

WdfUsbInterfaceGetConfiguredPipe호출하여 가져온 프레임워크 파이프 개체에 대한 핸들입니다.

[in, optional] Request

프레임워크 요청 개체에 대한 핸들입니다. 이 매개 변수는 선택 사항이며 NULL수 있습니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

[in, optional] RequestOptions

요청에 대한 옵션을 지정하는 호출자가 할당한 WDF_REQUEST_SEND_OPTIONS 구조체에 대한 포인터입니다. 이 포인터는 선택 사항이며 NULL수 있습니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

반환 값

WdfUsbTargetPipeResetSynchronously 작업이 성공하면 USB I/O 대상의 완료 상태 값을 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.

이 메서드는다른 NTSTATUS 값을 반환할 수도 있습니다.

드라이버에서 잘못된 개체 핸들을 제공하면 버그 검사가 수행됩니다.

발언

WdfUsbTargetPipeResetSynchronously 메서드를 사용하여 USB 재설정 요청을 동기적으로 보냅니다. 이러한 요청을 비동기적으로 보내려면 WdfUsbTargetPipeFormatRequestForReset사용하고 그 다음에 WdfRequestSend사용합니다.

프레임워크가 I/O 대상의 USB 파이프를 다시 설정하기 전에 I/O 대상의 큐에 남아 있는 모든 I/O 요청을 취소합니다. WdfUsbTargetPipeResetSynchronously 반환될 때까지 드라이버는 I/O 대상에 추가 I/O 요청을 보내지 않아야 합니다.

드라이버는 WdfUsbTargetPipeResetSynchronously호출하기 전에 WdfIoTargetStop 호출해야 합니다. WdfUsbTargetPipeResetSynchronously 반환을 후 드라이버는 WdfIoTargetStart호출할 수 있습니다.

드라이버가 WdfUsbTargetPipeResetSynchronously호출하면 프레임워크는 I/O 대상에 URB_FUNCTION_RESET_PIPE 요청을 보냅니다. USB 파이프를 다시 설정하는 방법에 대한 자세한 내용은 USB 사양을 참조하세요.

WdfUsbTargetPipeResetSynchronously 메서드는 요청이 완료될 때까지 반환되지 않으며, 드라이버가 RequestOptions 매개 변수가 가리키는 WDF_REQUEST_SEND_OPTIONS 구조에서 시간 제한 값을 제공하지 않거나 오류가 검색되지 않는 한 반환되지 않습니다.

드라이버가 I/O 큐에서 받은 I/O 요청을 전달하거나 새 요청을 만들고 보낼 수 있습니다.

드라이버가 I/O 큐에서 받은 I/O 요청을 전달하려면 WdfUsbTargetPipeResetSynchously 메서드의 Request 매개 변수에 대해 수신된 요청의 핸들을 지정합니다.

새 요청을 만들고 보내려면 Request 매개 변수에 대한 NULL 요청 핸들을 제공하거나 새 요청 개체를 만들고 해당 핸들을 제공합니다.

• NULL 요청 핸들을 제공하는 경우 프레임워크는 내부 요청 개체를 사용합니다. 이 기술은 사용하기는 간단하지만 드라이버는 요청을 취소할 수 없습니다.
• WdfRequestCreate 호출하여 하나 이상의 요청 개체를 만드는 경우 WdfRequestReuse호출하여 이러한 요청 개체를 다시 사용할 수 있습니다. 이 기술을 사용하면 드라이버의 EvtDriverDeviceAdd 콜백 함수가 디바이스에 대한 요청 개체를 미리 할당할 수 있습니다. 또한 필요한 경우 다른 드라이버 스레드가 WdfRequestCancelSentRequest 호출하여 요청을 취소할 수 있습니다.

I/O 요청이 완료된 후 상태 정보를 가져오는 방법에 대한 자세한 내용은 완료 정보 가져오기참조하세요.

WdfUsbTargetPipeResetSynchronously 메서드 및 USB I/O 대상에 대한 자세한 내용은 USB I/O 대상참조하세요.

예제

다음 코드 예제에서는 USB 디바이스의 파이프에 다시 설정 요청을 보냅니다.

NTSTATUS  status;

status = WdfUsbTargetPipeResetSynchronously(
                                            Pipe, 
                                            WDF_NO_HANDLE,
                                            NULL
                                            );

요구 사항

참고 항목

WdfObjectDereference

WdfRequestCancelSentRequest

WdfRequestSend

WdfUsbTargetPipeAbortSynchronously