NdisMapFile 関数 (ndis.h)

[アーティクル]
08/07/2023

NdisMapFile 関数は、ファイルが現在マップされていない場合に、既に開いているファイルを呼び出し元がアクセス可能なバッファーにマップします。

構文

void NdisMapFile(
  [out] PNDIS_STATUS Status,
  [out] PVOID        *MappedBuffer,
  [in]  NDIS_HANDLE  FileHandle
);

パラメーター

[out] Status

この関数がマッピング操作の状態を返す呼び出し元が指定した変数へのポインター。次のいずれかになります。

NDIS_STATUS_SUCCESS

呼び出し元は、 NdisUnmapFile 関数が呼び出されるまで、ファイルの内容に排他的にアクセスできます。

NDIS_STATUS_ALREADY_MAPPED

呼び出し元は、現時点ではファイルの内容にアクセスできません。

[out] MappedBuffer

呼び出し元が指定した変数へのポインター。この関数は、マップされたファイルの内容の基本仮想アドレスまたは NULL を返します。

[in] FileHandle

NdisOpenFile 関数の前の呼び出しによって返されたハンドル。

戻り値

なし

解説

NdisMapFile は、ドライバーがファイルの内容にアクセスできるように、仮想アドレス範囲を開いているファイルに関連付けます (マップ)。 NdisMapFile では、特定のファイルのマッピングをいつでも 1 つだけ未処理にすることができます。そのため、正常な呼び出し元には、 NdisUnmapFile または NdisCloseFile 関数が呼び出されるまで、ファイルデータへの排他アクセス権が付与されます。

ミニポートドライバーは、NdisMapFile と NdisUnmapFile への交互の呼び出しを使用して、必要に応じてこのような開いているファイルをマップおよびマップ解除できます。 NdisCloseFile の呼び出しは FileHandle を解放し、ファイルの内容を含むバッファーの割り当てを解除します。

ミニポートドライバーは、初期化中にのみ NdisMapFile を 呼び出すことができます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisMapFile (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisMapFile (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Video.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_Miscellaneous_Function(ndis)