StorPortGetUncachedExtension 関数 (storport.h)
StorPortGetUncachedExtension ルーチンは、CPU とデバイスによって共有されるキャッシュされていない共通バッファーを割り当てます。
構文
STORPORT_API PVOID StorPortGetUncachedExtension(
PVOID HwDeviceExtension,
PPORT_CONFIGURATION_INFORMATION ConfigInfo,
ULONG NumberOfBytes
);
パラメーター
HwDeviceExtension
ハードウェア デバイス拡張機能へのポインター。 これは、ポート ドライバーがミニポート ドライバーの代わりに割り当ておよび初期化する HBA 記憶域ごとの です。 ミニポート ドライバーは通常、HBA の状態や HBA のマップされたアクセス範囲など、この拡張機能に HBA 固有の情報を格納します。 この領域は、ミニポート ドライバーが StorPortInitialize を呼び出した直後に、ミニポート ドライバーで使用できます。 ポート ドライバーは、デバイスを削除すると、このメモリを解放します。
ConfigInfo
HBA の DMA 機能に関する情報を指定します。 DmaChannel または DmaPort、DmaWidth、DmaSpeed、MaximumTransferLength、ScatterGather、Master set to TRUE、NumberOfPhysicalBreaks、AdapterInterfaceType、Dma32BitAddresses、Dma64BitAddresses、SystemIoBusNumber、AutoRequestSense、および SrbExtensionSize のメンバーを入力する必要があります。
EISA バス マスター アダプターの DmaChannel など、HBA に関連しないメンバーはそのままにする必要があります。
NumberOfBytes
割り当てるキャッシュされていない拡張機能の必要なサイズ (バイト単位)。
戻り値
StorPortGetUncachedExtension は、キャッシュされていない拡張機能への仮想アドレス ポインターを返します。 要求されたメモリを割り当てることができない場合は、 NULL を返します。 メモリが以前に割り当てられた場合は、現在キャッシュされていない拡張機能への仮想アドレス ポインターが返されます。
注釈
バス マスター デバイスは、DMA 転送に共通のバッファー領域を使用します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | storport.h (Storport.h を含む) |
| Library | Storport.lib |