Метод IWDFIoRequest2::GetEffectiveIoType (wudfddi.h)

Статья
02/07/2025

[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]

Метод GetEffectiveIoType возвращает метод доступа к буферу, который используется UMDF для буферов данных запроса ввода-вывода, который представляет интерфейс IWDFIoRequest2.

Синтаксис

WDF_DEVICE_IO_TYPE GetEffectiveIoType();

Возвращаемое значение

GetEffectiveIoType возвращает WDF_DEVICE_IO_TYPEтипизированное значение, определяющее метод доступа к буферу, который используется UMDF для буферов данных запроса ввода-вывода.

Замечания

Дополнительные сведения о доступе к буферам данных и использовании драйвера GetEffectiveIoTypeсм. в статье Доступ к буферам данных в UMDF-Based драйверах.

Примеры

В следующем примере кода показано, как функция обратного вызова IQueueCallbackWrite::OnWrite может получить метод доступа к буферу запроса ввода-вывода.

VOID
STDMETHODCALLTYPE
  CMyQueue::OnWrite(
    __in IWDFIoQueue *pWdfQueue,
    __in IWDFIoRequest *pWdfRequest,
    __in SIZE_T BytesToWrite
    )
{
    WDF_DEVICE_IO_TYPE currentIoType;

    //
    // Declare an IWDFIoRequest2 interface pointer and obtain the
    // IWDFIoRequest2 interface from the IWDFIoRequest interface.
    //
    CComQIPtr<IWDFIoRequest2> r2 = pWdfRequest;

    currentIoType = r2->GetEffectiveIoType();
...
}

Требования

Требование	Ценность
завершение поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа	Настольный
минимальная версия UMDF	1.9
заголовка	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

См. также

IWDFIoRequest2

WDF_DEVICE_IO_TYPE (UMDF)

Поделиться через