WdfUsbTargetPipeFormatRequestForAbort 함수(wdfusb.h)
[KMDF 및 UMDF에 적용]
WdfUsbTargetPipeFormatRequestForAbort 메서드는 지정된 USB 파이프에 대한 중단 요청을 작성하지만 요청을 보내지 않습니다.
구문
NTSTATUS WdfUsbTargetPipeFormatRequestForAbort(
[in] WDFUSBPIPE Pipe,
[in] WDFREQUEST Request
);
매개 변수
[in] Pipe
WdfUsbInterfaceGetConfiguredPipe를 호출하여 가져온 프레임워크 파이프 개체에 대한 핸들입니다.
[in] Request
프레임워크 요청 개체에 대한 핸들입니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
반환 값
작업이 성공하면 WdfUsbTargetPipeFormatRequestForAbort는 I/O 대상의 완료 상태 값을 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
잘못된 매개 변수가 감지되었습니다. |
|
메모리가 부족했습니다. |
|
Request 매개 변수가 나타내는 IRP(I/O 요청 패킷)는 드라이버가 요청을 전달할 수 있는 충분한 IO_STACK_LOCATION 구조를 제공하지 않습니다. |
이 메서드는 다른 NTSTATUS 값을 반환할 수도 있습니다.
드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.
설명
WdfUsbTargetPipeFormatRequestForAbort와 WdfRequestSend를 사용하여 동기 또는 비동기적으로 USB 중단 요청을 보냅니다. 또는 WdfUsbTargetPipeAbortSynchronously 메서드를 사용하여 요청을 동기적으로 보냅니다.
USB 중단 요청으로 인해 드라이버의 I/O 대상이 파이프로 전송된 모든 I/O 요청을 취소합니다. 드라이버가 WdfRequestSend를 호출하면 프레임워크는 I/O 대상에 URB_FUNCTION_ABORT_PIPE 요청을 보냅니다. USB 파이프("파이프 중단"이라고도 함)에서 작업을 취소하는 방법에 대한 자세한 내용은 USB 사양을 참조하세요.
드라이버가 I/O 큐에서 받은 I/O 요청을 전달하거나 새 요청을 만들고 보낼 수 있습니다.
드라이버가 I/O 큐에서 받은 I/O 요청을 전달하려면 WdfUsbTargetPipeFormatRequestForAbort 메서드의 Request 매개 변수에 대해 수신된 요청 의 핸들을 지정합니다.
새 I/O 요청을 만들려면 WdfRequestCreate 를 호출하여 요청 개체를 미리 할당합니다. WdfUsbTargetPipeFormatRequestForAbort 메서드의 Request 매개 변수에 대한 요청 핸들을 입력합니다. WdfRequestReuse를 호출하여 요청 개체를 다시 사용할 수 있습니다. 드라이버의 EvtDriverDeviceAdd 콜백 함수는 디바이스에 대한 요청 개체를 미리 할당할 수 있습니다.
WdfUsbTargetPipeFormatRequestForAbort를 호출하여 I/O 요청의 형식을 지정한 후 드라이버는 WdfRequestSend를 호출하여 요청을 I/O 대상에 동기적으로 또는 비동기적으로 보내야 합니다.
동일한 요청을 사용하는 WdfUsbTargetPipeFormatRequestForAbort에 대한 여러 호출로 인해 추가 리소스 할당이 발생하지 않습니다. 따라서 WdfRequestCreate 가 STATUS_INSUFFICIENT_RESOURCES 반환할 가능성을 줄이기 위해 드라이버의 EvtDriverDeviceAdd 콜백 함수는 WdfRequestCreate 를 호출하여 디바이스에 대해 하나 이상의 요청 개체를 미리 할당할 수 있습니다. 이후에 드라이버는 WdfRequestCreate에 대한 이후 호출에서 STATUS_INSUFFICIENT_RESOURCES 반환 값을 위험하지 않고 다시 사용(WdfRequestReuse 호출), reformat(WdfUsbTargetPipeFormatRequestForAbort 호출) 및 각 요청 개체를 다시 STATUS_INSUFFICIENT_RESOURCES 수 있습니다. 재사용된 요청 개체에 대한 WdfUsbTargetPipeFormatRequestForAbort 에 대한 모든 후속 호출은 매개 변수 값이 변경되지 않으면 STATUS_SUCCESS 반환합니다. 드라이버가 매번 동일한 요청 형식 메서드를 호출하지 않으면 추가 리소스가 할당될 수 있습니다.
I/O 요청이 완료된 후 상태 정보를 가져오는 방법에 대한 자세한 내용은 완료 정보 가져오기를 참조하세요.
WdfUsbTargetPipeFormatRequestForAbort 메서드 및 USB I/O 대상에 대한 자세한 내용은 USB I/O 대상을 참조하세요.
예제
다음 코드 예제에서는 USB 파이프에 대한 중단 요청의 형식을 지정하고 CompletionRoutine 콜백 함수를 등록하고 요청을 보냅니다.
status = WdfUsbTargetPipeFormatRequestForAbort(
pipe,
Request
);
if (!NT_SUCCESS(status)) {
goto Exit;
}
WdfRequestSetCompletionRoutine(
Request,
AbortCompletionRoutine,
pipe
);
if (WdfRequestSend(
Request,
WdfUsbTargetPipeGetIoTarget(pipe),
WDF_NO_SEND_OPTIONS
) == FALSE) {
status = WdfRequestGetStatus(Request);
goto Exit;
}
Exit:
if (!NT_SUCCESS(status)) {
WdfRequestCompleteWithInformation(
Request,
status,
0
);
}
return;
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfusb.h(Wdfusb.h 포함) |
| 라이브러리 | Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), RequestFormattedValid(kmdf), RequestForUrbXrb(kmdf), RequestSendAndForgetNoFormatting(kmdf), RequestSendAndForgetNoFormatting2(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |