NdisOpenFile 関数 (ndis.h)

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

NdisOpenFile 関数は、開かれたファイルのハンドルを返します。

構文

void NdisOpenFile(
  [out] PNDIS_STATUS          Status,
  [out] PNDIS_HANDLE          FileHandle,
  [out] PUINT                 FileLength,
  [in]  PNDIS_STRING          FileName,
  [in]  NDIS_PHYSICAL_ADDRESS HighestAcceptableAddress
);

パラメーター

[out] Status

呼び出し元が指定した変数へのポインター。この関数は、開いているファイル操作の状態を返します。これは、次のいずれかになります。

NDIS_STATUS_SUCCESS

FileHandle のハンドルは、NdisMapFile の後続の呼び出しに対して有効です。

NDIS_STATUS_FILE_NOT_FOUND

FileName の指定された文字列に、システムオブジェクト名前空間で見つかった名前が指定されていませんでした。

NDIS_STATUS_RESOURCES

NDIS は、ファイルを開き、ファイルの内容のバッファーを割り当てるために必要なリソースを割り当てませんでした。

NDIS_STATUS_ERROR_READING_FILE

指定されたファイルのデータを、呼び出し元による後続のアクセスのためにシステムメモリに読み込めませんでした。

[out] FileHandle

呼び出しが成功した場合に、この関数が開かれたファイルのハンドルを返す、呼び出し元が指定した変数へのポインター。

[out] FileLength

呼び出し元が指定した変数へのポインター。この関数は、呼び出しが成功した場合に、開かれたファイル内のデータのバイト数を書き込みます。

[in] FileName

初期化されたカウントされた文字列を含むNDIS_STRING型へのポインター。システムの既定の文字セット内で、開くファイルに名前を付けます。 Windows 2000 以降のドライバーの場合、この文字列には Unicode 文字が含まれます。つまり、Windows 2000 以降の場合、NDIS はNDIS_STRING型を UNICODE_STRING 型として定義します。

[in] HighestAcceptableAddress

ファイルデータを格納できる最大の物理アドレス。ドライバーが制限を設けなかった場合は -1 を指定します。

戻り値

なし

解説

NdisOpenFile はディスクファイルを開きます。通常、ドライバーは後でインテリジェント NIC をプログラムするためにダウンロードするファイルです。 NdisOpenFile は、 NdisMapFile 関数に対するドライバーの後続の呼び出しのファイルの内容を保持する記憶域も割り当てます。

ミニポートドライバーは、ミニポートInitializeEx 関数からのみ NdisOpenFile を呼び出す必要があります。

NdisOpenFile が返されると、ミニポートドライバーは NdisMapFile を呼び出すことによってファイルデータにアクセスできます。 NdisUnmapFile 関数を呼び出してファイルをページングし、ドライバーがファイルデータにアクセスしていない間にリソースを不必要に消費しないようにすることができます。ファイルの使用が完了したら、 MiniportInitializeEx はを呼び出す必要があります。
NdisCloseFile 関数。

注意

NDISOpenFile、 NdisCloseFile、 NdisMapFile 、 NdisUnmapFile は ARM64 ではサポートされていません。 ARM64 では、これらの関数を ZwCreateFile、 ZwReadFile、またはその他の同様の操作の呼び出しに置き換えます。

要件

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