IWDFIoQueue::P urge 메서드(wudfddi.h)

아티클
02/07/2025

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

Purge 메서드는 프레임워크에 들어오는 새 I/O 요청을 거부하고 모든 미해결 요청을 취소하도록 지시합니다.

통사론

void Purge(
  [in, optional] IQueueCallbackStateChange *pPurgeComplete
);

매개 변수

[in, optional] pPurgeComplete

프레임워크가 드라이버에 큐 상태를 제공하기 위해 호출하는 IQueueCallbackStateChange 인터페이스에 대한 포인터입니다. 프레임워크는 모든 요청이 취소된 후 메서드를 호출합니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.

반환 값

없음

발언

프레임워크는 큐에서 처리되지 않은 요청을 취소합니다. 드라이버에 전달되고 취소 가능으로 표시된 요청의 경우 프레임워크는 IRequestCallbackCancel::OnCancel호출합니다.

드라이버는 지정된 시간에 다음 방법 중 하나만 진행 중인지 확인해야 합니다.

예를 들어 이전에 제거호출한 드라이버의 경우 pPurgeComplete 매개 변수가 중지 또는 드레이닝호출하기 전에 인터페이스 메서드에서 가리키는 알림을 기다려야 합니다. 이 규칙을 위반하면 호스트 프로세스가 종료됩니다.

예제

다음 코드 예제에서는 큐에 대한 요청을 중지하는 방법을 보여 줍니다.

VOID
CUmdfHidFile::OnCleanupFile(
    __in IWDFFile* /* WdfFile */
    )
/*++
    This method handles the cleanup operation for the file object.  
    Because the file is disabled, no new reports should be added to the ring buffer.
--*/
{
    this->Disable();

    //
    // Stop all current requests to read reports.
    //

    m_GetReportQueue->Purge(NULL);
}

요구 사항

요구	값
지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	바탕 화면
최소 UMDF 버전	1.5
헤더	wudfddi.h(Wudfddi.h 포함)
DLL	WUDFx.dll