IWDFIoTargetStateManagement：：Start 方法 (wudfddi.h)

  • 项目

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

Start 方法开始将排队请求发送到本地 I/O 目标。

语法

HRESULT Start();

返回值

如果操作成功，Start 将返回S_OK。 否则，此方法可能会返回错误代码之一：

返回代码 说明
HRESULT_FROM_NT (STATUS_INVALID_DEVICE_STATE)
设备已移除。
 

此方法可能会返回 Winerror.h 定义的其他错误代码之一。

注解

如果驱动程序可以检测到可恢复的设备错误，你可能希望驱动程序调用 IWDFIoTargetStateManagement：：Stop 以暂时停止向本地 I/O 目标发送请求，然后稍后调用 “开始” 以继续发送请求。

此外，如果驱动程序调用 IWDFUsbTargetPipe2：：ConfigureContinuousReader 为 USB 管道配置连续读取器，则驱动程序的 IPnpCallback：：OnD0Entry 回调函数必须调用 Start 才能启动读取器。

驱动程序必须同步调用 Start 和 IWDFIoTargetStateManagement：：Stop 。 驱动程序调用其中一个函数后，不得在第一个函数返回之前调用另一个函数。

有关 “开始”的详细信息，请参阅 在 UMDF 中控制常规 I/O 目标的状态。

有关 I/O 目标的详细信息，请参阅 在 UMDF 中使用 I/O 目标。

示例

下面的代码示例首先演示了驱动程序如何获取 USB 管道对象的 IWDFIoTargetStateManagement 接口。 然后，代码示例演示如果驱动程序使用 USB 管道的连续读取器， IPnpCallback：：OnD0Entry 回调函数如何调用 Start。


    IWDFIoTargetStateManagement * m_pIoTargetInterruptPipeStateMgmt = NULL;

    IWDFUsbTargetFactory *  pIUsbTargetFactory = NULL;
    IWDFUsbTargetDevice *   pIUsbTargetDevice = NULL;
    IWDFUsbInterface *      pIUsbInterface = NULL;
    IWDFUsbTargetPipe *     pIUsbPipe = NULL;

    hr = m_FxDevice->QueryInterface(IID_PPV_ARGS(&pIUsbTargetFactory));
    if (FAILED(hr))
    {...}
    hr = pIUsbTargetFactory->CreateUsbTargetDevice(&pIUsbTargetDevice);
    if (FAILED(hr))
    {...}
    hr = pIUsbTargetDevice->RetrieveUsbInterface(0, &pIUsbInterface);
    if (FAILED(hr))
    {...}
    NumEndPoints = pIUsbInterface->GetNumEndPoints();
    for (UCHAR PipeIndex = 0; PipeIndex < NumEndPoints; PipeIndex++)
    {
        hr = pIUsbInterface->RetrieveUsbPipeObject(PipeIndex, &pIUsbPipe);
        if (FAILED(hr))
        {...}
        else
        {
            if (pIUsbPipe->IsInEndPoint())
            {
                if (UsbdPipeTypeInterrupt == pIUsbPipe->GetType())
                {
                    m_pIUsbInterruptPipe = pIUsbPipe;
                    hr = m_pIUsbInterruptPipe->QueryInterface(IID_PPV_ARGS(&m_pIoTargetInterruptPipeStateMgmt));
                    if (FAILED(hr))
                    {...}
                }
            }
        }
    } 

HRESULT
CMyDevice::OnD0Entry(
    __in IWDFDevice*  pWdfDevice,
    __in WDF_POWER_DEVICE_STATE  previousState
    )
{
...
    m_pIoTargetInterruptPipeStateMgmt->Start();
...
    return S_OK;
}

要求

要求 值
结束支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.5
标头 wudfddi.h (包括 Wudfddi.h)
DLL WUDFx.dll

另请参阅

IWDFIoTargetStateManagement

IWDFRemoteTarget：：Stop