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 コールバック関数の詳細については、「 フレームワーク ファイル オブジェクト」を参照してください。

要件

こちらもご覧ください

WDF_FILEOBJECT_CONFIG