次の方法で共有

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

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY