次の方法で共有


NdisAllocateTimerObject 関数 (ndis.h)

NdisAllocateTimerObject 関数は、後続の NdisXxx タイマー関数で使用するタイマー オブジェクトを割り当てて初期化します。

構文

NDIS_STATUS NdisAllocateTimerObject(
  [in]  NDIS_HANDLE                 NdisHandle,
  [in]  PNDIS_TIMER_CHARACTERISTICS TimerCharacteristics,
  [out] PNDIS_HANDLE                pTimerObject
);

パラメーター

[in] NdisHandle

呼び出し元の初期化中に取得された NDIS ハンドル。 NDIS ハンドルの取得の詳細については、「プール ハンドルの取得 を参照してください。

[in] TimerCharacteristics

呼び出し元が指定したポインター NDIS_TIMER_CHARACTERISTICS 割り当てられたタイマー オブジェクトの特性を指定する構造体です。

[out] pTimerObject

NDISXxxタイマー関数への後続の呼び出しでタイマー オブジェクト を識別するために NDIS が提供する NDIS タイマー オブジェクト ハンドルへのポインター。

戻り値

NdisAllocateTimerObject は、次のいずれかの状態値を返します。

リターン コード 形容
NDIS_STATUS_SUCCESS
タイマー オブジェクトが正常に割り当てられています。
NDIS_STATUS_RESOURCES
リソースが不足しているため、割り当てに失敗しました。
NDIS_STATUS_BAD_CHARACTERISTICS
NDIS_TIMER_CHARACTERISTICS構造体の情報が無効であるため、割り当てに失敗しました。
NDIS_STATUS_FAILURE
上記の状態値は適用されていません。

備考

タイマー サービスを使用するには、NDIS ドライバーは、最初にタイマー オブジェクトを初期化する NdisAllocateTimerObject 関数を呼び出します。 通常、NdisAllocateTimerObject はドライバーの初期化中に呼び出されます。

タイマーを開始するには、NdisSetTimerObject 関数を呼び出します。 NdisSetTimerObject 呼び出 システム タイマー キューにタイマー オブジェクトを挿入します。 特定のタイマー オブジェクトのインスタンスは、任意の時点で 1 つだけキューに入れられます。

タイマーを取り消すには、NdisCancelTimerObject 関数を呼び出します。 NdisCancelTimerObject 、タイマー オブジェクトが現在キューに入っている場合はデキューします。

タイマー オブジェクトを解放するには、NdisFreeTimerObject 関数を呼び出す必要があります。

必要条件

要件 価値
サポートされる最小クライアント NDIS 6.0 以降でサポートされています。
ターゲット プラットフォーム 万国
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 する Irql_Timer_Function(ndis)

関連項目

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject