WDF_IO_QUEUE_CONFIG_INIT関数 (wdfio.h)
[KMDF と UMDF に適用]
WDF_IO_QUEUE_CONFIG_INIT関数は、ドライバーのWDF_IO_QUEUE_CONFIG構造体を初期化します。
構文
void WDF_IO_QUEUE_CONFIG_INIT(
[out] PWDF_IO_QUEUE_CONFIG Config,
[in] WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);
パラメーター
[out] Config
ドライバーの WDF_IO_QUEUE_CONFIG 構造体へのポインター。
[in] DispatchType
キューの要求ディスパッチの種類を識別する WDF_IO_QUEUE_DISPATCH_TYPE 列挙子。
戻り値
なし
解説
ドライバーは、デバイスの既定のキューではない電源マネージド I/O キューを作成するときに、 WDF_IO_QUEUE_CONFIG_INIT を呼び出す必要があります。 WDF_IO_QUEUE_CONFIG_INIT関数は、指定したWDF_IO_QUEUE_CONFIG構造体をゼロにし、その Size メンバーを設定します。 また、 PowerManaged メンバーを WdfUseDefault に設定し、 DispatchType メンバーに指定されたディスパッチ型を格納します。
KMDF バージョン 1.9 以降、 DispatchType が WdfIoQueueDispatchParallel に設定されている場合、 WDF_IO_QUEUE_CONFIG_INIT 構造体の NumberOfPresentedRequests メンバーが -1 に設定されます。 この値は、フレームワークがドライバーに無制限の数の I/O 要求を配信できることを示します。
例
次のコード例では 、WDF_IO_QUEUE_CONFIG構造体を 初期化し、 WdfIoQueueCreate を呼び出します。
WDF_IO_QUEUE_CONFIG queueConfig;
NTSTATUS status = STATUS_SUCCESS;
WDFQUEUE readQueue;
WDF_IO_QUEUE_CONFIG_INIT(
&queueConfig,
WdfIoQueueDispatchManual
);
status = WdfIoQueueCreate(
hDevice,
&queueConfig,
WDF_NO_OBJECT_ATTRIBUTES,
&readQueue
);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfio.h (Wdf.h を含む) |