portcls.h ヘッダー

このヘッダーはオーディオで使用されます。 詳細については、次を参照してください。

• オーディオ

portcls.h には、次のプログラミング インターフェイスが含まれています。

インターフェイス

IAdapterPnpManagement IAdapterPnpManagement は、アダプターが PnP 管理メッセージを受信する場合に実装して登録する必要があるインターフェイスです。
IAdapterPowerManagement IAdapterPowerManagement インターフェイスは、オーディオ アダプターの電源状態を管理するために使用されます。
IAdapterPowerManagement2 IAdapterPowerManagement2 インターフェイスは IUnknown から継承され、オーディオ アダプターの電源状態を管理するために使用されます。
IAdapterPowerManagement3 IAdapterPowerManagement3 インターフェイスは IUnknown から継承され、電源管理メッセージを受信するために使用されます。
IDmaChannel IDmaChannel インターフェイスは、DMA チャネルとそれに関連付けられている DMA バッファーと使用パラメーターの抽象化を提供します。
IDmaChannelSlave IDmaChannelSlave インターフェイスは、下位デバイスの DMA チャネルを監視および制御するためのメソッドを提供します (「アダプター オブジェクトの概要」の説明に従います)。
IDrmPort IDrmPort インターフェイスは、DRM で保護されたコンテンツを管理するために WaveCyclic または WavePci ミニポート ドライバーによって使用されます (「Digital Rights Management」を参照)。
IDrmPort2 IDrmPort2 インターフェイスは、DRM で保護されたコンテンツを管理するために WaveCyclic または WavePci ミニポート ドライバーによって使用されます (「Digital Rights Management」を参照)。
IInterruptSync IInterruptSync インターフェイスは、割り込みサービス ルーチン (ISR) の一覧の実行を ISR 以外のルーチンと同期する割り込み同期オブジェクトを表します。
IMiniport IMiniport インターフェイスは、すべてのミニポート オブジェクトがサポートする汎用ミニポート インターフェイスです。 IMiniport は IUnknown インターフェイスから継承します。
IMiniportAudioEngineNode このインターフェイスを使用すると、ミニポート ドライバーは KS フィルター ハンドルを介してオーディオ エンジンにアクセスする KS プロパティを使用できます。
IMiniportAudioSignalProcessing IMiniportAudioSignalProcessing インターフェイスは、任意のオーディオ ドライバーの WaveRT ミニポート コンポーネントによって実装されます(そのピンのいずれかがオーディオ信号処理モードをサポートしている場合)。
IMiniportMidi IMiniport Midi インターフェイスは、MIDI シンセサイザー デバイスの MIDI ミニポート ドライバーのプライマリ インターフェイスです。
IMiniportMidiStream IMiniport MidiStream インターフェイスは、MIDI フィルターのピンを通過する MIDI ストリームを表します。
IMiniportPnpNotify IMiniportPnpNotify は、ミニポート オブジェクト (オーディオ サブデバイス) が PnP 状態変更通知を受信できるようにするオプションのインターフェイスです。
IMiniportStreamAudioEngineNode このインターフェイスを使用すると、ミニポート ドライバーは、ピン インスタンス ハンドルを介してオーディオ エンジンにアクセスする KS プロパティを使用できます。
IMiniportStreamAudioEngineNode2 IMiniportStreamAudioEngineNode2 インターフェイスを使用すると、オーディオ ミニポート ドライバーで IMiniportStreamAudioEngineNode インターフェイスの機能を拡張できます。
IMiniportTopology IMiniportTopology インターフェイスは、トポロジ ミニポート ドライバーのプライマリ インターフェイスです。
IMiniportWaveCyclic IMiniportWaveCyclic インターフェイスは、WaveCyclic オーディオ デバイスのミニポート ドライバーによって公開されるプライマリ インターフェイスです。
IMiniportWaveCyclicStream IMiniportWaveCyclicStream インターフェイスは、WaveCyclic フィルターのピンを通過するウェーブ ストリームを表します。
IMiniportWavePci IMiniportWavePci インターフェイスは、WavePci オーディオ デバイスのミニポート ドライバーによって公開されるプライマリ インターフェイスです。
IMiniportWavePciStream IMiniportWavePciStream インターフェイスは、WavePci フィルターのピンを通過するウェーブ ストリームを表します。
IMiniportWaveRT IMiniportWaveRT インターフェイスは、WaveRT オーディオ デバイスのミニポート ドライバーによって公開されるプライマリ インターフェイスです。
IMiniportWaveRTInputStream IMiniportWaveRTInputStream インターフェイスは、WaveRT レンダリングまたはキャプチャ デバイスをラップする KS フィルターのピンを通過する入力ウェーブ ストリームを表します。 IMiniportWaveRTInputStream は IUnknown インターフェイスから継承します。
IMiniportWaveRTOutputStream IMiniportWaveRTOutputStream インターフェイスは、出力ウェーブ ストリームを表します。 IMiniportWaveRTOutputStream は IUnknown インターフェイスから継承します。
IMiniportWaveRTStream IMiniportWaveRTStream インターフェイスは、WaveRT レンダリングまたはキャプチャ デバイスをラップする KS フィルターのピンを通過するウェーブ ストリームを表します。
IMiniportWaveRTStreamNotification IMiniportWaveRTStreamNotification インターフェイスは、Windows Vista 以降の Windows オペレーティング システムでサポートされており、IMiniportWaveRTStream インターフェイスを拡張し、DMA ドライバー イベント通知を容易にする追加のメソッドを提供します。
IMusicTechnology IMusicTechnology インターフェイスは、MIDI または DMus ミニポート ドライバーに属するピンのデータ範囲記述子で指定されている音楽技術 GUID を変更するために使用されます。
IPinCount IPinCount インターフェイスは、ミニポート ドライバーが監視し、ピンがインスタンス化され、閉じると、そのピン数を動的に操作するための手段を提供します。
IPinName Windows 7 以降のオペレーティング システムでは、IPinName インターフェイスは、オーディオ エンドポイントの名前を報告および更新するためにミニポート ドライバーによって使用されます。
IPort IPort インターフェイスは、オーディオ ポート ドライバーの汎用インターフェイスです。 すべてのオーディオ ポート ドライバーは、下端の一部として IPort を公開します。 アダプター ドライバーは、このインターフェイスで初期化メソッドを呼び出します。 IPort は IUnknown インターフェイスから継承します。
IPortClsEtwHelper IPortClsEtwHelper インターフェイスを使用すると、オーディオ ミニポート ドライバーは、Windows イベント トレーシング (ETW) ヘルパー関数にアクセスできます。
IPortClsNotifications オーディオ モジュール通信をサポートするミニポートに通知ヘルパーを提供するポートによって実装されるインターフェイス。
IPortClsPnp IPortClsPnp は、ポート クラス ドライバー (PortCls) がアダプターに公開する PnP 管理インターフェイスです。
IPortClsPower IPortClsPower インターフェイスは、Windows Vista 以降のバージョンの Windows でサポートされています。 IPortClsPower は、ポート クラス ドライバー (PortCls) がアダプターに公開する電源管理インターフェイスです。
IPortClsRuntimePower IPortClsRuntimePower は、ポート クラス ドライバー (PortCls) がオーディオ アダプターのランタイム電源管理機能にアクセスするために使用するインターフェイスです。
IPortClsStreamResourceManager IPortClsStreamResourceManager は、オーディオ ストリーム リソースの登録を管理するために使用されます。
IPortClsStreamResourceManager2 IPortClsStreamResourceManager2 は、オーディオ ストリーム リソースの登録を管理するために使用されます。
IPortClsVersion IPortClsVersion インターフェイスは、ドライバーが実行されている Windows オペレーティング システムのバージョンを識別するためにミニポート ドライバーによって使用されます。 ポート ドライバーは、このインターフェイスを実装し、ミニポート ドライバーに公開します。
IPortEvents IPortEvents インターフェイスは、ハードウェア イベントをクライアントに通知するためにミニポート ドライバーによって使用されます。
IPortMidi IPort Midi インターフェイスは、MIDI ポート ドライバーのプライマリ インターフェイスです。
IPortTopology IPortTopology インターフェイスは、トポロジ ミニポート ドライバーに汎用ポート ドライバーのサポートを提供します。
IPortWaveCyclic IPortWaveCyclic インターフェイスは、WaveCyclic ポート ドライバーのプライマリ インターフェイスです。
IPortWavePci IPortWavePci インターフェイスは、WavePci ポート ドライバーのプライマリ インターフェイスです。
IPortWavePciStream IPortWavePciStream インターフェイスは、WavePci ミニポート ストリーム オブジェクトへのマッピング サービスを提供するストリーム関連のコールバック インターフェイスです。
IPortWaveRT IPortWaveRT インターフェイスは、Windows Vista 以降のオペレーティング システムでサポートされており、WaveRT ポート ドライバーが WaveRT ミニポート ドライバー オブジェクトを実装するアダプター ドライバーに公開するメイン インターフェイスです。
IPortWaveRTStream IPortWaveRTStream インターフェイスは、Windows Vista 以降のオペレーティング システムでサポートされており、WaveRT ミニポート ドライバーで使用するヘルパー メソッドを提供するストリーム固有のインターフェイスです。
IPortWMIRegistration IPortWMIRegistration インターフェイスは、Windows 7 以降のバージョンの Windows で提供されています。 このインターフェイスを使用すると、ミニポート ドライバーは、PortCls とミニポート ドライバー間の Windows イベント トレーシング (ETW) 登録を調整できます。
IPowerNotify IPowerNotify インターフェイスは、ミニポート ドライバーが差し迫った電源状態の変更の事前通知を必要とする場合に公開できるオプションのインターフェイスです。
IPreFetchOffset IPreFetchOffset インターフェイスはプリフェッチ オフセットを制御します。これは、DirectSound 出力ストリーム内の再生カーソルと書き込みカーソルを分離するバイト数です。
IRegistryKey IRegistryKey インターフェイスは、ミニポート ドライバーがキーとそのサブキーにアクセスするために使用できるレジストリ キーの抽象化を提供します。
IResourceList IResourceList インターフェイスは、構成リソース リストの抽象化を提供します。これは、プラグ アンド プレイ マネージャーが起動時にデバイスに割り当てるシステム ハードウェア リソースの一覧です。
IServiceGroup IServiceGroup インターフェイスは、すべて同じサービス要求の通知を必要とするオブジェクトのグループをカプセル化します。
IServiceSink IServiceSink インターフェイスは、サービス要求の処理をカプセル化します。
IUnregisterPhysicalConnection IUnregisterPhysicalConnection インターフェイスには、登録済みの物理接続を削除する 3 つのメソッドが実装されています。
IUnregisterSubdevice IUnregisterSubdevice インターフェイスは、登録済みのサブデバイスを削除するメソッドを実装します。

関数

PcAddAdapterDevice PcAddAdapterDevice 関数は、WDM デバイス スタックにアダプター デバイスを追加します。
PcAddContentHandlers PcAddContentHandlers 関数は、保護されたコンテンツを処理する関数の一覧をシステムに提供します。
PcAddStreamResource PcAddStreamResource はストリーム リソースを追加します。
PcCompleteIrp PcCompleteIrp 関数は、以前に保留中としてマークされていた IRP を完了します。
PcCompletePendingPropertyRequest 保留中のプロパティ要求を完了するために、PcCompletePendingPropertyRequest 関数が呼び出されます。
PcCreateContentMixed PcCreateContentMixed 関数は、いくつかの KS オーディオ ストリームの混合コンテンツを含む複合ストリームの DRM コンテンツ権限を計算します。
PcDestroyContent PcDestroyContent 関数は、PcCreateContentMixed によって作成された DRM コンテンツ ID を削除します。 この関数の呼び出しは、DrmDestroyContent 関数の操作では同じであり、そのパラメーター定義と戻り値も同じであることに注意してください。
PcDispatchIrp PcDispatchIrp 関数は、PortCls システム ドライバーの既定のハンドラーに IRP をディスパッチします。
PcForwardContentToDeviceObject PcForwardContentToDeviceObject 関数は、呼び出し元が保護されたコンテンツを転送するデバイスを表すデバイス オブジェクトを受け入れます。
PcForwardContentToFileObject PcForwardContentToFileObject 関数は廃止され、既存のドライバーをサポートするためにのみ維持されます。
PcForwardContentToInterface PcForwardContentToInterface 関数は、呼び出し元が保護されたコンテンツを転送するオブジェクトの COM インターフェイスへのポインターを受け取ります。
PcForwardIrpSynchronous PcForwardIrpSynchronous 関数は、プラグ アンド プレイ IRP を物理デバイス オブジェクト (PDO) に転送するために IRP ハンドラーによって使用されます。
PcGetContentRights PcGetContentRights 関数は、DRM コンテンツ ID に割り当てられた DRM コンテンツ権限を取得します。 この関数呼び出しは DrmGetContentRights 関数と同じ操作であり、そのパラメーター定義と戻り値も同じであることに注意してください。
PcGetDeviceProperty PcGetDeviceProperty 関数は、レジストリから要求されたデバイス プロパティを返します。
PcGetPhysicalDeviceObject PcGetPhysicalDeviceObject 関数を使用すると、オーディオ ミニポート ドライバーは、オーディオ デバイスの基になる物理デバイス オブジェクトを取得できます。
PcGetTimeInterval PcGetTimeInterval 関数は、指定した時刻以降の経過時間を返します。 時間は 100 ナノ秒単位で測定されます。
PcInitializeAdapterDriver PcInitializeAdapterDriver 関数は、アダプター ドライバーを PortCls システム ドライバーにバインドします。
PcNewDmaChannel PcNewDmaChannel 関数は、新しい DMA チャネル オブジェクトを作成します。 この関数は廃止されました。詳細については、次のコメントを参照してください。
PcNewInterruptSync PcNewInterruptSync 関数は、割り込み同期オブジェクトを作成して初期化します。
PcNewMiniport PcNewMiniport 関数は、PortCls システム ドライバーに組み込まれているシステム提供のミニポート ドライバーの 1 つのインスタンスを作成 portcls.sys。
PcNewPort PcNewPort 関数は、新しいシステム提供のポート ドライバー オブジェクトを作成します。このオブジェクトのインターフェイス (基底クラス IPort から派生) はクラス ID で指定されます。
PcNewRegistryKey PcNewRegistryKey 関数は、新しいレジストリ キーを開くか作成し、キーを表す IRegistryKey オブジェクトを作成します。 呼び出し元は、このオブジェクトを介してキーにアクセスします。
PcNewResourceList PcNewResourceList 関数は、リソース リストを作成して初期化します。
PcNewResourceSublist PcNewResourceSublist 関数は、別のリソース リストから派生した空のリソース リストを作成して初期化します。
PcNewServiceGroup PcNewServiceGroup 関数は、サービス グループを作成して初期化します。
PcRegisterAdapterPnpManagement PcRegisterAdapterPnpManagement 関数は、アダプターの PnP 管理インターフェイスを PortCls システム ドライバーに登録します。 PnP の再調整をサポートするために使用されます。
PcRegisterAdapterPowerManagement PcRegisterAdapterPowerManagement 関数は、アダプターの電源管理インターフェイスを PortCls システム ドライバーに登録します。
PcRegisterIoTimeout PcRegisterIoTimeout 関数は、指定されたデバイス オブジェクトのドライバー提供の I/O タイマー コールバック ルーチンを登録します。
PcRegisterPhysicalConnection PcRegisterPhysicalConnection 関数は、同じアダプター ドライバーによってインスタンス化された 2 つのオーディオ アダプター フィルター間の物理的な接続を登録します。
PcRegisterPhysicalConnectionFromExternal PcRegisterPhysicalConnectionFromExternal 関数は、外部オーディオ アダプター フィルターからオーディオ アダプター フィルターへの物理接続を登録します。
PcRegisterPhysicalConnectionToExternal PcRegisterPhysicalConnectionToExternal 関数は、オーディオ アダプター フィルターから外部オーディオ アダプター フィルターへの物理接続を登録します。
PcRegisterSubdevice PcRegisterSubdevice 関数は、サブデバイスを登録して、クライアントで使用できるようにします。
PcRemoveStreamResource PcRemoveStreamResource は、既存のストリーム リソースを削除します。
PcRequestNewPowerState PcRequestNewPowerState 関数は、デバイスの新しい電源状態を要求するために使用されます。 この関数は、通常、アダプター ドライバーでは必要ありませんが、場合によっては、いくつかの種類のハードウェアの問題を回避するのに役立つことがあります。
PcUnregisterAdapterPnpManagement PcUnregisterAdapterPnpManagement 関数は、PortCls クラス ドライバーからオーディオ アダプターの PnP 管理インターフェイスの登録を解除します。 PnP の再調整をサポートするために使用されます。
PcUnregisterAdapterPowerManagement PcUnregisterAdapterPowerManagement 関数は、PortCls クラス ドライバーからオーディオ アダプターの電源管理インターフェイスの登録を解除します。 PcUnregisterAdapterPowerManagement 関数は、Windows 7 以降のバージョンの Windows で使用できます。
PcUnregisterIoTimeout PcUnregisterIoTimeout 関数は、指定されたデバイス オブジェクトのドライバー提供の I/O タイマー コールバック ルーチンの登録を解除します。

コールバック関数

PCPFNEVENT_HANDLER EventHandler ルーチンは、イベント要求を処理します。

構造

PCAUTOMATION_TABLE PCAUTOMATION_TABLE構造体には、プロパティ、メソッド、およびイベントのミニポート ドライバーのマスター テーブルが含まれています。
PCEVENT_ITEM PCEVENT_ITEM構造体は、特定のフィルター、ピン、またはノードでサポートされるイベントを記述するために使用されます。
PCEVENT_REQUEST PCEVENT_REQUEST構造体は、イベント要求を指定します。
PCFILTER_DESCRIPTOR PCFILTER_DESCRIPTOR構造体は、ミニポート ドライバーのフィルターの実装について説明します。 構造体は、フィルターのピン、ノード、接続、およびプロパティを指定します。
PCMETHOD_ITEM PCMETHOD_ITEM構造体は、フィルター、ピン、またはノードでサポートされるメソッドを記述します。
PCMETHOD_REQUEST PCMETHOD_REQUEST構造体は、メソッド要求を指定します。
PCNODE_DESCRIPTOR PCNODE_DESCRIPTOR構造体は、トポロジ ミニポート ドライバーが実装するフィルター内のノードを記述します。
PCNOTIFICATION_BUFFER IPortClsNotifications によって使用される通知バッファー。
PCPIN_DESCRIPTOR PCPIN_DESCRIPTOR構造では、ピン ファクトリについて説明します。
PCPROPERTY_ITEM PCPROPERTY_ITEM構造体は、特定のフィルター、ピン、またはノードでサポートされるプロパティを記述します。
PCPROPERTY_REQUEST PCPROPERTY_REQUEST構造体は、プロパティ要求を指定します。
PCSTREAMRESOURCE_DESCRIPTOR PCSTREAMRESOURCE_DESCRIPTORストリーム リソースを定義します。 この構造体を正しく初期化するには、PCSTREAMRESOURCE_DESCRIPTOR_INITを使用します。

列挙

eChannelTargetType eChannelTargetType 列挙は、特定のチャネル内のノード (ターゲット) の種類を指定する定数を定義します。
eEngineFormatType eEngineFormatType 列挙は、オーディオ エンジンでサポートされるオーディオ データ型を指定する定数を定義します。
EPcMiniportEngineEvent このトピックでは、EPcMiniportEngineEvent 列挙型について説明し、ミニポート ドライバーがグリッチ エラーを報告するときに追加情報を提供するパラメーターについて説明します。
PC_EXIT_LATENCY このトピックでは、PC_EXIT_LATENCY列挙型について説明し、そのメンバーについて説明します。 待機時間は、デバイスがスリープ状態を終了し、完全に機能する状態 (D0) を入力できる必要がある特定の最大時間にマップされます。
PC_REBALANCE_TYPE PC_REBALANCE_TYPE列挙型では、再調整のサポートの種類について説明します。
PcStreamResourceType このトピックでは、PcStreamResourceType 列挙型について説明し、そのメンバーについて説明します。 PcStreamResourceType 列挙型は、特定のオーディオ ストリーミングに使用されるリソースの種類を定義するために使用されます。