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 ターゲットへの要求の送信を一時的に停止し、後で Start を呼び出して要求の送信を再開することができます。

さらに、ドライバーが IWDFUsbTargetPipe2::ConfigureContinuousReader を呼び出して USB パイプの連続リーダーを構成する場合、ドライバーの IPnpCallback::OnD0Entry コールバック関数は Start を呼び出してリーダーを起動する必要があります。

ドライバーは Start と IWDFIoTargetStateManagement::Stop を同期的に呼び出す必要があります。 ドライバーは、これらの関数のいずれかを呼び出した後、最初の関数が返される前に、もう一方の関数を呼び出してはなりません。

Start の詳細については、「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
Header wudfddi.h (Wudfddi.h を含む)
[DLL] WUDFx.dll

こちらもご覧ください

IWDFIoTargetStateManagement

IWDFRemoteTarget::Stop