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();

返回值

如果作成功，启动 将返回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 接口。 然后，代码示例演示 IPnpCallback：：OnD0Entry 回调函数如何调用 Start（如果驱动程序对 USB 管道使用连续读取器）。

    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