次の方法で共有


DRIVER_CONTROL コールバック関数 (wdm.h)

このルーチンは、DMA データ転送またはデータ転送操作を開始します。

構文

DRIVER_CONTROL DriverControl;

IO_ALLOCATION_ACTION DriverControl(
  [in]      _DEVICE_OBJECT *DeviceObject,
  [in, out] _IRP *Irp,
  [in]      PVOID MapRegisterBase,
  [in]      PVOID Context
)
{...}

パラメーター

[in] DeviceObject

DEVICE_OBJECT構造体への呼び出し元から指定されたポインター。 これは、ドライバーの AddDevice ルーチンによって以前に作成されたターゲット デバイスのデバイス オブジェクトです。

[in, out] Irp

IRP 構造体への呼び出し元が指定したポインター。 Irp は、コールバック ルーチンが登録されたときに DeviceObjectCurrentIrp メンバーの値と等しくなります。

[in] MapRegisterBase

AdapterControl の場合、これは、システムがこの転送操作に割り当てたマップ レジスタを表す、呼び出し元が指定した不透明な値です。 ドライバーは、 FlushAdapterBuffersFreeMapRegistersおよび MapTransfer にこの値を渡します。

ControllerControl の場合、これは使用されません。

[in] Context

AllocateAdapterChannel の以前の呼び出しで指定された、ドライバー定義のコンテキスト情報への呼び出し元指定のポインター。

戻り値

ルーチンは、 IO_ALLOCATION_ACTION 列挙で定義されている値のいずれかを返す必要があります。 バス マスター デバイスのドライバーは、 DeallocateObject または DeallocateObjectKeepRegisters を返します。システム DMA を使用するドライバーは KeepObject を返します

注釈

特定のデバイス オブジェクトの AdapterControl ルーチンを登録するには、ドライバーは IoGetDmaAdapter を呼び出してアダプター オブジェクトを取得し、 AllocateAdapterChannel を呼び出してアダプターの使用を要求し 、AdapterControl ルーチンのアドレスを指定する必要があります。 アダプターが空いている場合、システムは AdapterControl ルーチンを呼び出します。

AdapterControlStartIo ルーチンによって登録されている場合、Irp パラメーターは、StartIo ルーチンによって現在処理されている IRP を指す保証されます。 それ以外の場合、ドライバーは AllocateAdapterChannel を呼び出す前に、デバイス オブジェクト構造体の CurrentIrp メンバーを設定する必要があります。

AdapterControl ルーチンの実装の詳細については、「AdapterControl ルーチンの記述」を参照してください。

ドライバーの ControllerControl ルーチンは、IRQL = DISPATCH_LEVELで任意のスレッド コンテキストで実行されます。

特定のデバイス オブジェクトの ControllerControl ルーチンを登録するには、ドライバーが IoCreateController を 呼び出してコントローラー オブジェクトを取得し、 IoAllocateController を呼び出してコントローラーの使用を要求し 、ControllerControl ルーチンのアドレスを指定する必要があります。 コントローラーが解放されると、システムは ControllerControl ルーチンを呼び出します。

ControllerControl ルーチンの実装の詳細については、「ControllerControl ルーチンの記述」を参照してください。 「 コントローラー オブジェクト」も参照してください。

DRIVER_CONTROL関数の種類は、Wdm.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、必ず注釈を _Use_decl_annotations_ 関数定義に追加してください。 注釈により _Use_decl_annotations_ 、ヘッダー ファイル内のDRIVER_CONTROL関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「 WDM ドライバーの関数ロール型を使用して関数を宣言する」を参照してください。 の詳細 _Use_decl_annotations_については、「 関数の動作に注釈を付ける」を参照してください。

コールバック ルーチンを定義するには、まず、定義するコールバック ルーチンの種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数型のセットが用意されています。 コールバック関数の種類を使用して関数を宣言すると、 ドライバーのコード分析静的ドライバー検証ツール (SDV)、およびその他の検証ツールでエラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。

たとえば、 という名前MyAdapterControlAdapterControl コールバック ルーチンを定義するには、次のコード例に示すように、DRIVER_CONTROL型を使用します。

DRIVER_CONTROL MyAdapterControl;

次に、コールバック ルーチンを次のように実装します。

_Use_decl_annotations_
IO_ALLOCATION_ACTION
 MyAdapterControl(
    struct _DEVICE_OBJECT  *DeviceObject,
    struct _IRP  *Irp,
    PVOID  MapRegisterBase,
    PVOID  Context
    )
  {
      // Function body
  }

要件

要件
対象プラットフォーム デスクトップ
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
IRQL DISPATCH_LEVELで呼び出されます。

こちらもご覧ください

AllocateAdapterChannel