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 檔案物件。

規格需求

另請參閱

WDF_FILEOBJECT_CONFIG