IWDFIoRequest2::GetEffectiveIoType 方法(wudfddi.h)

[警告: UMDF 2 是最新版本的 UMDF,取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1,并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅 UMDF入门 。]

GetEffectiveIoType 方法返回 UMDF 用于 I/O 请求的数据缓冲区的缓冲区访问方法,IWDFIoRequest2 接口表示。

语法

WDF_DEVICE_IO_TYPE GetEffectiveIoType();

返回值

GetEffectiveIoType 返回 WDF_DEVICE_IO_TYPE类型化值,该值标识 UMDF 用于 I/O 请求的数据缓冲区的缓冲区访问方法。

言论

有关访问数据缓冲区以及驱动程序何时应使用 getEffectiveIoType的详细信息,请参阅 访问 UMDF-Based 驱动程序中的数据缓冲区。

例子

下面的代码示例演示了 IQueueCallbackWrite::OnWrite 回调函数如何获取 I/O 请求的缓冲区访问方法。

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 (包括 Wudfddi.h)
DLL WUDFx.dll

另请参阅

IWDFIoRequest2

WDF_DEVICE_IO_TYPE (UMDF)