WdfRequestForwardToIoQueue 関数 (wdfrequest.h)

[KMDF と UMDF に適用]

WdfRequestForwardToIoQueue メソッドは、呼び出し元ドライバーの I/O キューのいずれかに I/O 要求を再キューします。

構文

NTSTATUS WdfRequestForwardToIoQueue(
  [in] WDFREQUEST Request,
  [in] WDFQUEUE   DestinationQueue
);

パラメーター

[in] Request

フレームワーク要求オブジェクトへのハンドル。

[in] DestinationQueue

フレームワーク キュー オブジェクトへのハンドル。

戻り値

操作が成功した場合、WdfRequestForwardToIoQueue はSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは次のいずれかの値を返す可能性があります。

このメソッドは、他の NTSTATUS 値も返す場合があります。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

ドライバーは I/O 要求を 所有 している必要があり、その I/O キューのいずれかから要求を取得している必要があります。

ソース キューと宛先キューを同じにすることはできません。 言い換えると、ドライバーは WdfRequestForwardToIoQueue を呼び出して、元のキューに要求を返すことはできません。 同じキューに要求を再キューするには、 WdfRequestRequeue を使用します。

ソース キューと宛先キューの両方が同じデバイスに属している必要があります。

要求を取り消し可能にすることはできません。 ドライバーが WdfRequestMarkCancelable または WdfRequestMarkCancelableEx を呼び出して要求を取り消し可能にした場合は、WdfRequestForwardToIoQueue を呼び出す前に WdfRequestUnmarkCancelable を呼び出す必要があります。

ドライバーが WdfRequestForwardToIoQueue を呼び出した後、フレームワークが新しいキューからドライバーに要求を配信するまで、ドライバーは再キューされた要求を所有しません。 要求が新しいキューにある間、フレームワークは要求を所有し、ドライバーに通知せずに要求を取り消すことができます。

WdfRequestForwardToIoQueue が返される前に、次のイベントが発生する可能性があります。

• 宛先キューが空の場合、フレームワークは再キュー化された I/O 要求を宛先キューの 要求ハンドラーのいずれかに配信できます。
• ソース キューの ディスパッチメソッド が順次または並列の場合、フレームワークはソース キューの要求ハンドラーのいずれかに別の要求を配信できます。

例

次のコード例は、PCIDRV サンプル ドライバーからの EvtIoDeviceControl コールバック関数です。 受信した要求に IOCTL_NDISPROT_INDICATE_STATUS の I/O 制御コードが含まれている場合、ドライバーは WdfRequestForwardToIoQueue を呼び出して、要求を別の I/O キューに移動します。

VOID
PciDrvEvtIoDeviceControl(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  OutputBufferLength,
    IN size_t  InputBufferLength,
    IN ULONG  IoControlCode
    )
{
    NTSTATUS  status= STATUS_SUCCESS;
    PFDO_DATA  fdoData = NULL;
    WDFDEVICE  hDevice;
    WDF_REQUEST_PARAMETERS  params;

    UNREFERENCED_PARAMETER(OutputBufferLength);
    UNREFERENCED_PARAMETER(InputBufferLength);

    hDevice = WdfIoQueueGetDevice(Queue);
    fdoData = FdoGetData(hDevice);

    WDF_REQUEST_PARAMETERS_INIT(&params);
    WdfRequestGetParameters(
                            Request,
                            &params
                            );

    switch (IoControlCode)
    {
        case IOCTL_NDISPROT_QUERY_OID_VALUE:
            NICHandleQueryOidRequest(
                                     Queue,
                                     Request,
                                     &params
                                     );
            break;

        case IOCTL_NDISPROT_SET_OID_VALUE:
            NICHandleSetOidRequest(
                                   Queue,
                                   Request,
                                   &params
                                   );
            break;

        case IOCTL_NDISPROT_INDICATE_STATUS:
            status = WdfRequestForwardToIoQueue(
                                                Request,
                                                fdoData->PendingIoctlQueue
                                                );
            if(!NT_SUCCESS(status)){
                WdfRequestComplete(
                                   Request,
                                   status
                                   );
                break;
            }
            break;

        default:
            WdfRequestComplete(
                               Request,
                               STATUS_INVALID_DEVICE_REQUEST
                               );
            break;
    }
    return;
}

要件

こちらもご覧ください

EvtDestroyCallback

WdfRequestMarkCancelable

WdfRequestMarkCancelableEx

WdfRequestRequeue

WdfRequestUnmarkCancelable