EVT_WDF_DEVICE_FILE_CREATE回呼函式 (wdfdevice.h)
[適用於 KMDF 和 UMDF]
驅動程式的 EvtDeviceFileCreate 回呼函式會處理應用程式要求存取裝置時必須執行的作業。
語法
EVT_WDF_DEVICE_FILE_CREATE EvtWdfDeviceFileCreate;
void EvtWdfDeviceFileCreate(
[in] WDFDEVICE Device,
[in] WDFREQUEST Request,
[in] WDFFILEOBJECT FileObject
)
{...}
參數
[in] Device
架構裝置物件的句柄。
[in] Request
架構要求物件的句柄，表示檔案建立要求。
[in] FileObject
架構檔案物件的句柄，描述針對指定要求開啟的檔案。 如果驅動程式已為 WDF_FILEOBJECT_CONFIG 結構的 FileObjectClass 成員指定 WdfFileObjectNotRequired，則此參數為 NULL。
傳回值
無
備註
當使用者應用程式或其他驅動程式開啟裝置以執行 I/O 作業時，架構會呼叫驅動程式的 EvtDeviceFileCreate 回呼函式，例如讀取或寫入檔案。
驅動程式可以將 要求 句柄傳遞至 WdfRequestGetParameters ，以擷取與檔案建立要求相關聯的參數。 參數會儲存在 WDF_REQUEST_PARAMETERS 結構的 Parameters.Create 成員中。
這個回呼函式會在開啟裝置的線程內容中同步呼叫。
若要註冊 EvtDeviceFileCreate 回呼函式，驅動程式必須呼叫 WdfDeviceInitSetFileObjectConfig 方法。
驅動程式必須完成要求，或使用 WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET傳送它。
或者，驅動程式可以在佇列中接收建立要求。 如需詳細資訊，請參閱 WdfDeviceConfigureRequestDispatching。
如需架構檔案物件和 EvtDeviceFileCreate 回呼函式的詳細資訊，請參閱 Framework 檔案物件。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 最低UMDF版本 | 2.0 |
| 標頭 | wdfdevice.h (包含 Wdf.h) |
| IRQL | PASSIVE_LEVEL |