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_TIMER_CHARACTERISTICS構造体の情報が無効であるため、割り当てに失敗しました。 |
|
上記の状態値は適用されていません。 |
備考
タイマー サービスを使用するには、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) |
関連項目
NdisCancelTimerObject の
NdisFreeTimerObject の
NdisSetTimerObject の