WdfRequestAllocateTimer 函式 (wdfrequest.h)
[適用於 KMDF 和 UMDF]
WdfRequestAllocateTimer 方法會為指定的 I/O 要求配置定時器。
NTSTATUS WdfRequestAllocateTimer(
[in] WDFREQUEST Request
);
[in] Request
架構要求物件的句柄。
如果作業成功,WdfRequestAllocateTimer 會傳回STATUS_SUCCESS。 否則,此方法可能會傳回下列其中一個值:
傳回碼 | 描述 |
---|---|
|
輸入參數無效。 |
|
無法配置定時器。 |
此方法也可能 傳回其他NTSTATUS 值。
如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。
如果您的驅動程式在呼叫 WdfRequestSend時指定逾時值,則應該先呼叫 WdfRequestAllocateTimer,再呼叫 WdfRequestSend。 這可確保如果系統資源不足而無法配置定時器,則呼叫 WdfRequestSend 將不會失敗。
如果已為指定的要求配置定時器,WdfRequestAllocateTimer 會傳回STATUS_SUCCESS。
下列程式代碼範例會初始化 WDF_REQUEST_SEND_OPTIONS 結構、配置 I/O 要求的定時器物件,然後呼叫 WdfRequestSend。
NTSTATUS status;
WDF_REQUEST_SEND_OPTIONS options;
BOOLEAN requestSend;
WDF_REQUEST_SEND_OPTIONS_INIT(
&options,
WDF_REQUEST_SEND_OPTION_TIMEOUT
);
WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT(
&options,
WDF_ABS_TIMEOUT_IN_SEC(TIME_OUT_VALUE)
);
status = WdfRequestAllocateTimer(
request
);
if (!NT_SUCCESS(status)){
return status;
...
requestSend = WdfRequestSend(
request,
ioTarget,
&options
);
}
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
標頭 | wdfrequest.h (包括 Wdf.h) |
連結庫 | Wdf01000.sys (KMDF):WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
DDI 合規性規則 | DriverCreate(kmdf),InvalidReqAccess(kmdf),InvalidReqAccessLocal(kmdf),KmdfIrql(kmdf),KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf) |