WdfRequestGetStatus 함수(wdfrequest.h)

  • 아티클

[KMDF 및 UMDF에 적용]

WdfRequestGetStatus 메서드는 I/O 요청의 상태 반환합니다.

구문

NTSTATUS WdfRequestGetStatus(
  [in] WDFREQUEST Request
);

매개 변수

[in] Request

프레임워크 요청 개체에 대한 핸들입니다.

반환 값

WdfRequestGetStatus 는 NTSTATUS 값을 반환합니다. 반환할 수 있는 값에 대한 자세한 내용은 다음 설명 섹션을 참조하세요.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

WdfRequestGetStatus 메서드는 다음 중 하나를 반환합니다.

  • WdfRequestSend에 대한 드라이버의 호출이 성공하면 WdfRequestGetStatus는 지정된 요청을 완료하기 위해 WdfRequestComplete를 호출하는 드라이버에서 설정한 상태 값을 반환합니다. 드라이버는 일반적으로 CompletionRoutine 콜백 함수 내에서 WdfRequestGetStatus를 호출합니다.
  • WdfRequestSend에 대한 드라이버의 호출이 실패하면 WdfRequestGetStatus는 프레임워크가 오류를 설명하도록 설정한 상태 값을 반환합니다. 드라이버는 WdfRequestSend 를 호출한 직후 WdfRequestGetStatus를 호출할 수 있습니다.
드라이버가 WdfRequestSend를 호출할 때 요청에 대한 WDF_REQUEST_SEND_OPTION_SYNCHRONOUS 플래그를 설정하는 경우 WdfRequestSend 호출의 성공 여부와 실패 여부에 관계없이 드라이버가 WdfRequestGetStatus를 호출한 직후 WdfRequestGetStatus를 호출할 수 있습니다.

요청 완료에 대한 자세한 내용은 I/O 요청 완료를 참조하세요.

예제

다음 코드 예제는 KbFiltr 샘플 드라이버에서 가져옵니다. 이 예제에서는 I/O 요청을 I/O 대상에 보냅니다. WdfRequestSend가 실패하면 이 예제에서는 WdfRequestGetStatus 반환 값을 WdfRequestComplete에 대한 입력으로 사용합니다.

VOID
KbFilter_ForwardRequest(
    IN WDFREQUEST Request,
    IN WDFIOTARGET Target
    )
{
    WDF_REQUEST_SEND_OPTIONS options;
    BOOLEAN ret;
    NTSTATUS status;

    WDF_REQUEST_SEND_OPTIONS_INIT(
                                  &options,
                                  WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET
                                  );

    ret = WdfRequestSend(
                         Request,
                         Target,
                         &options
                         );

    if (ret == FALSE) {
        status = WdfRequestGetStatus (Request);
        DebugPrint(("WdfRequestSend failed: 0x%x\n", status));
        WdfRequestComplete(
                           Request,
                           status
                           );
    }
    return;
}

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
최소 UMDF 버전 2.0
머리글 wdfrequest.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL <=DISPATCH_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), RequestGetStatusValid(kmdf)

추가 정보

CompletionRoutine

WdfRequestComplete

WdfRequestSend