IMiniportWaveRTStreamNotification::RegisterNotificationEvent メソッド (portcls.h)
メソッドは RegisterNotificationEvent
、DMA ドリブン イベント通知の通知を受け取るイベントを登録します。
構文
NTSTATUS RegisterNotificationEvent(
[in] PKEVENT NotificationEvent
);
パラメーター
[in] NotificationEvent
DMA が進行すると通知用に登録されるカーネル イベント (PKEVENT) へのポインター。
戻り値
RegisterNotificationEvent
は、呼び出しが成功した場合は STATUS_SUCCESS の状態値を返します。 それ以外の場合、メソッドは適切なエラー状態コードを返します。
注釈
ポート ドライバーは、クライアントからの KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT プロパティ要求に応答して、このメソッドを呼び出します。 ポート ドライバーは、ユーザー モード イベント ハンドルをカーネル イベント ポインターにマップし、 NotificationEvent パラメーターを使用して ポインターを渡します。
通常、DMA ドリブン イベント通知が有効になっている場合、DMA ハードウェアは、巡回オーディオ バッファー内の目的の通知ポイントでハードウェア割り込みを生成するようにプログラムされます。 ドライバー割り込みサービス ルーチン (ISR) がこの割り込みを検出すると、遅延プロシージャ 呼び出し (DPC) がキューに入れられます。 次に、DPC によって、登録された各イベントが通知されます。 呼び出しを通知するイベントを囲む try/except コンストラクトを使用することをお勧めします。
KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT プロパティの動作の詳細については、 KSRTAUDIO_NOTIFICATION_EVENT_PROPERTYを参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista 以降の Windows オペレーティング システムで使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | portcls.h |
IRQL | パッシブ レベル。 |
こちらもご覧ください
IMiniportWaveRTStreamNotification