WDF_REQUEST_SEND_OPTIONS構造体 (wdfrequest.h)
[KMDF と UMDF に適用]
WDF_REQUEST_SEND_OPTIONS 構造体は、I/O ターゲットへの I/O 要求の送信に関連付けられているオプションを指定します。
構文
typedef struct _WDF_REQUEST_SEND_OPTIONS {
ULONG Size;
ULONG Flags;
LONGLONG Timeout;
} WDF_REQUEST_SEND_OPTIONS, *PWDF_REQUEST_SEND_OPTIONS;
メンバーズ
Size
この構造体のサイズ (バイト単位)。
Flags
WDF_REQUEST_SEND_OPTIONS_FLAGS型指定されたフラグのビットごとの OR。
Timeout
システム時間単位 (100 ナノ秒間隔) のタイムアウト値。 ドライバーがWDF_REQUEST_SEND_OPTION_TIMEOUT フラグを設定している場合、フレームワークは、指定されたタイムアウト期間内に完了していない場合、関連付けられている I/O 要求を取り消します。 タイムアウト値は、次のように負、正、またはゼロにすることができます。
- 値が負の場合、有効期限は現在のシステム時刻を基準とします。
- 値が正の場合、有効期限は絶対時間として指定されます (実際には 1601 年 1 月 1 日を基準とします)。
- 値が 0 の場合、フレームワークは要求をタイムアウトしません。
フレームワークには、時間値をシステム時間単位に変換する 時間変換関数が用意されています。
指定したタイムアウト期間が経過したためにフレームワークが I/O 要求を取り消した場合、フレームワークは I/O 要求に対してSTATUS_IO_TIMEOUTの完了状態を提供します。 ただし、タイムアウト期間が経過すると、I/O ターゲットが I/O 要求を完了してから、フレームワークで取り消しが行われる可能性があります。 その場合、I/O 要求の完了状態はSTATUS_IO_TIMEOUTされません。
備考
WDF_REQUEST_SEND_OPTIONS 構造体は、WdfRequestSend メソッドなど、I/O ターゲットに I/O 要求を送信するオブジェクト メソッドに渡されます。 構造体は、WDF_REQUEST_SEND_OPTIONS_INIT 関数と WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT 関数を呼び出すことによって初期化する必要があります。
ドライバーが同期的に要求を送信している場合は、ドライバーがこの構造体のメンバー フラグのタイムアウト値とタイムアウト フラグを設定することをお勧めします。
必要条件
| 要件 | 価値 |
|---|---|
| 最小 KMDF バージョン | 1.0 |
| UMDF の最小バージョン を する | 2.0 |
| ヘッダー | wdfrequest.h (Wdf.h を含む) |
関連項目
WDF_REQUEST_SEND_OPTIONS_FLAGS