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