WDF_IO_QUEUE_IDLE 함수(wdfio.h)

아티클
02/27/2024

[KMDF 및 UMDF에 적용]

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

구문

BOOLEAN WDF_IO_QUEUE_IDLE(
  [in] WDF_IO_QUEUE_STATE State
);

매개 변수

[in] State

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

반환 값

지정된 큐 상태가 큐가 유휴 상태임을 나타내는 경우 WDF_IO_QUEUE_IDLE TRUE 를 반환합니다. 그렇지 않으면 함수는 FALSE를 반환 합니다.

설명

큐에 I/O 요청이 없고 배달된 모든 요청이 완료되거나 취소된 경우 I/O 큐가 유휴 상태입니다.

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

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

예제

다음 코드 예제는 지정된 I/O 큐가 유휴 상태이면 TRUE 를 반환하는 루틴입니다.

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