IWDFIoQueue::RetrieveNextRequest 메서드(wudfddi.h)

  • 아티클

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

RetrieveNextRequest 메서드는 I/O 큐에서 다음 I/O 요청을 검색합니다.

구문

HRESULT RetrieveNextRequest(
  [out] IWDFIoRequest **ppRequest
);

매개 변수

[out] ppRequest

다음 요청 개체에 대한 IWDFIoRequest 인터페이스에 대한 포인터를 받거나 큐가 비어 있거나 다음 요청을 찾을 수 없는 경우 NULL 을 수신하는 버퍼에 대한 포인터입니다.

반환 값

RetrieveNextRequest 는 다음 값 중 하나를 반환합니다.

반환 코드 Description
S_OK
 다음 I/O 요청이 I/O 큐에서 성공적으로 검색되었습니다.
HRESULT_FROM_NT(STATUS_WDF_PAUSED)
 큐가 요청을 디스패치하지 않습니다. 이 상황은 디바이스가 전원 상태 전환을 거치고 모든 큐가 요청을 디스패치하는 것을 중지하거나 드라이버가 명시적으로 IWDFIoQueue::Stop 을 호출하여 요청 디스패치를 중지하는 경우에 발생합니다. 이 상황은 드라이버가 전원이 관리되고 전원이 다운된 수동 큐에서 요청을 제거하려고 하거나 큐가 일시 중지된 경우에도 발생할 수 있습니다.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)
 큐에 요청이 없습니다.
HRESULT_FROM_NT(STATUS_INVALID_DEVICE_STATE)
 병렬 큐에서 요청을 검색하기 위해 호출되었습니다.
 

RetrieveNextRequest 는 다른 HRESULT 값도 반환할 수 있습니다.

설명

드라이버가 I/O 요청을 수동으로 디스패치하도록 I/O 큐를 구성하는 경우 드라이버는 RetrieveNextRequest 메서드를 호출하여 큐에서 다음 요청을 가져올 수 있습니다. I/O 요청을 수동으로 디스패치하는 방법에 대한 자세한 내용은 I/O 큐에 대한 디스패치 모드 구성을 참조하세요.

드라이버가 I/O 요청을 순차적으로 디스패치하도록 I/O 큐를 구성하는 경우 드라이버는 여전히 RetrieveNextRequest 메서드를 호출하여 오류를 수신하지 않고 큐에서 다음 요청을 가져올 수 있습니다. 프레임워크는 드라이버가 RetrieveNextRequest 를 호출하여 순차 큐에서 요청을 검색할 수 있도록 허용하지만 드라이버는 드라이버가 현재 요청을 완료하기 전에 RetrieveNextRequest 만 호출해야 합니다. 그렇지 않으면 드라이버가 현재 요청을 완료한 후 드라이버가 RetrieveNextRequest 를 호출하려고 하면 경합 상태가 발생할 수 있습니다. 이 경합 조건은 프레임워크가 순차 큐에서 다음 요청을 자동으로 디스패치하고 드라이버가 RetrieveNextRequest 를 호출하여 다음 요청을 검색하는 사이에 발생합니다.

예제

umdf_fx2 샘플 드라이버의 다음 코드 예제는 요청을 검색할 수 있는 한 큐에서 요청을 폴링합니다. 코드는 먼저 요청이 특정 파일 개체와 연결되어 있는지 확인합니다.

VOID
CMyDevice::ServiceSwitchChangeQueue(
    __in SWITCH_STATE NewState,
    __in HRESULT CompletionStatus,
    __in_opt IWDFFile *SpecificFile
    )
{
    IWDFIoRequest *fxRequest;
    HRESULT enumHr = S_OK;
    do {
        HRESULT hr;
        //
        // Get the next request.
        //
        if (NULL != SpecificFile) {
        enumHr = m_SwitchChangeQueue->RetrieveNextRequestByFileObject(
                                        SpecificFile,
                                        &fxRequest
                                        );
        }
        else {
            enumHr = m_SwitchChangeQueue->RetrieveNextRequest(&fxRequest);
        }
        //
        // If a request was retrieved, complete it.
        //
        if (S_OK == enumHr) {
            if (S_OK == CompletionStatus) {
                IWDFMemory *fxMemory;
                //
                // Copy the result to the request buffer.
                //
                fxRequest->GetOutputMemory(&fxMemory);
                hr = fxMemory->CopyFromBuffer(0, 
                                              &NewState, 
                                              sizeof(SWITCH_STATE));
                                              fxMemory->Release();
            }
            else {
                 hr = CompletionStatus;
            }
            //
            // Complete the request with the copy or 
            // completion status.
            //
            if (S_OK == hr) {
                fxRequest->CompleteWithInformation(hr, 
                                                   sizeof(SWITCH_STATE));
            }
            else {
                fxRequest->Complete(hr);
            }
            fxRequest->Release();
        }
    }
    while (S_OK == enumHr);
}

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.5
머리글 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

추가 정보

IWDFIoQueue

IWDFIoQueue::Stop

IWDFIoRequest