EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST コールバック関数 (wdfqueryinterface.h)

[KMDF にのみ適用]

ドライバーの EvtDeviceProcessQueryInterfaceRequest イベント コールバック関数は、フレームワークが要求するドライバーにインターフェイスを渡す前に、ドライバー定義インターフェイスへのアクセスについて別のドライバーの要求を調べます。

構文

EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST EvtWdfDeviceProcessQueryInterfaceRequest;

NTSTATUS EvtWdfDeviceProcessQueryInterfaceRequest(
  [in]      WDFDEVICE Device,
  [in]      LPGUID InterfaceType,
  [in, out] PINTERFACE ExposedInterface,
  [in, out] PVOID ExposedInterfaceSpecificData
)
{...}

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] InterfaceType

ドライバー定義インターフェイスを識別する GUID へのポインター。

[in, out] ExposedInterface

インターフェイスへのポインター ドライバー定義インターフェイスを記述し、インターフェイスへのアクセスを要求しているドライバーによって提供された構造体です。

[in, out] ExposedInterfaceSpecificData

追加の省略可能なドライバー定義のインターフェイス固有の情報へのポインター。 フレームワーク ベースのドライバーは、WdfFdoQueryForInterfaceを呼び出すときに、以外の NULLInterfaceSpecificData パラメーター値 指定することで、この値を指定します。

戻り値

EvtDeviceProcessQueryInterfaceRequest コールバック関数がサポートする GUID を受け取り、エラーが発生しない場合は、STATUS_SUCCESSまたは NT_SUCCESS(status) が TRUEと等しい別の状態値 返す必要があります。 フレームワークは引き続きスタックに要求を渡して、追加のドライバーがインターフェイスもサポートしているかどうかを確認します。

EvtDeviceProcessQueryInterfaceRequest コールバック関数は、特定のケースではインターフェイスにサービスを提供しないと判断した場合、STATUS_NOT_SUPPORTEDを返す必要があります。 フレームワークは引き続きスタックに要求を渡して、別のドライバーがインターフェイスをサポートしているかどうかを確認します。 この状況の詳細については、次の「解説」セクションを参照してください。

コールバック関数でエラーが発生した場合は、NT_SUCCESS(status) が FALSE等しい状態値を返す必要があります。 フレームワークは、インターフェイスに対する他のドライバーの要求に失敗し、要求をスタックに渡しません。

備考

フレームワーク ベースのドライバーは、WdfDeviceAddQueryInterfaceを呼び出すことによって、EvtDeviceProcessQueryInterfaceRequest イベント コールバック関数を登録します。

ドライバー定義インターフェイスが一方向の通信のみをサポートし、インターフェイスを記述する WDF_QUERY_INTERFACE_CONFIG 構造体の ImportInterface メンバーを FALSE設定する場合、EvtDeviceProcessQueryInterfaceRequest コールバック関数 は省略可能です。 別のドライバーが WdfFdoQueryForInterface呼び出すと、フレームワークは、要求するドライバーの INTERFACE 構造体にドライバー定義のインターフェイス値をコピーし、コールバック関数を呼び出します。 一方向の通信では、ドライバーが要求するドライバーに返される前に、インターフェイス値を調べて変更する場合にのみ、コールバック関数を提供する必要があります。

ドライバーが双方向通信をサポートするインターフェイスを定義する (WDF_QUERY_INTERFACE_CONFIG 構造体の ImportInterface メンバーを TRUEに設定する) 場合、ドライバーは、EvtDeviceProcessQueryInterfaceRequest イベント コールバック関数 提供する必要があります。 ImportInterface が TRUE され、別のドライバーが WdfFdoQueryForInterface呼び出した場合、フレームワークはドライバー定義インターフェイスを要求元のドライバーのインターフェイス構造にコピーしないため、コールバック関数が必要です。 代わりに、コールバック関数は、要求するドライバーのインターフェイス構造を更新する必要があります。

コールバック関数はインターフェイスを変更できます。 特に、次のことができます。

• インターフェイスの任意のメンバー内の任意の値を変更します。
• INTERFACE 構造体の Context メンバーを変更して、動的インスタンス固有のコンテキストを割り当てます。

EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST  MyDeviceProcessQueryInterfaceRequest;

_Use_decl_annotations_
NTSTATUS
 MyDeviceProcessQueryInterfaceRequest (
    WDFDEVICE  Device,
    LPGUID  InterfaceType,
    PINTERFACE  ExposedInterface,
    PVOID  ExposedInterfaceSpecificData
    )
  {...}