WDF_IO_QUEUE_DRAINED 함수(wdfio.h)

[KMDF 및 UMDF에 적용]

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

구문론

BOOLEAN WDF_IO_QUEUE_DRAINED(
  [in] WDF_IO_QUEUE_STATE State
);

매개 변수

[in] State

WdfIoQueueGetState 반환하는 WDF_IO_QUEUE_STATE형식화된 값입니다.

반환 값

지정된 큐 상태가 큐가 드레이닝되었음을 나타내는 경우 WDF_IO_QUEUE_DRAINEDTRUE 반환합니다. 그렇지 않으면 함수는 FALSE 반환합니다.

비고

새 I/O 요청을 수락하지 않고 큐에 있던 모든 요청이 드라이버에 전달된 경우 I/O 큐가 드레이닝됩니다.

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

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

예시

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

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