WDF_IO_QUEUE_PURGED 함수(wdfio.h)

아티클
02/29/2024

[KMDF 및 UMDF에 적용]

I/O 큐의 상태가 큐가 드레이닝되었음을 나타내는 경우 WDF_IO_QUEUE_PURGED 함수는 TRUE 를 반환합니다.

구문

BOOLEAN WDF_IO_QUEUE_PURGED(
  [in] WDF_IO_QUEUE_STATE State
);

매개 변수

[in] State

WdfIoQueueGetState가 반환하는 WDF_IO_QUEUE_STATE 형식의 값입니다.

반환 값

지정된 큐 상태가 큐가 제거되었음을 나타내는 경우 WDF_IO_QUEUE_PURGED TRUE 를 반환합니다. 그렇지 않으면 함수는 FALSE를 반환 합니다.

설명

큐가 비어 있고 새 I/O 요청을 수락하지 않는 경우 및 큐에 있던 모든 요청이 취소된 경우 I/O 큐가 제거됩니다.

드라이버가 WdfIoQueueGetState를 호출한 후 WDF_IO_QUEUE_PURGED 호출할 수 있습니다.

I/O 큐 상태에 대한 자세한 내용은 WDF_IO_QUEUE_STATE.

예제

다음 코드 예제는 지정된 I/O 큐가 제거된 경우 TRUE 를 반환하는 루틴입니다.

BOOLEAN
IsQueuePurged(
    IN WDFQUEUE Queue
    )
{
    WDF_IO_QUEUE_STATE queueStatus;
    queueStatus = WdfIoQueueGetState(
                                     Queue,
                                     NULL,
                                     NULL
                                     );
    return (WDF_IO_QUEUE_PURGED(queueStatus)) ? TRUE : FALSE;
}