NdisMapFile 関数 (ndis.h)

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) を参照) でサポートされています。
ターゲット プラットフォーム の	万国
ヘッダー	ndis.h (Video.h を含む)
ライブラリ	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則 を する	Irql_Miscellaneous_Function(ndis)

関連項目

ミニポートInitializeEx

NdisCloseFile の

NdisOpenFile の

NdisUnmapFile の