NdisOpenFile 函式 (ndis.h)

發行項
02/26/2024

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 函式的檔案內容。

迷你埠驅動程序應該只從MiniportInitializeEx函式呼叫 NdisOpenFile。

當 NdisOpenFile 傳回時，迷你埠驅動程式可以藉由呼叫 NdisMapFile 來存取檔案數據。它可以呼叫 NdisUnmapFile 函式來分頁出檔案，因此在驅動程式未存取檔案數據時，不會不必要地取用資源。使用檔案完成時， MiniportInitializeEx 必須呼叫
NdisCloseFile 函式。

注意

ARM64 不支援 NdisOpenFile、NdisCloseFile、NdisMapFile 和 NdisUnmapFile。在ARM64上，以呼叫 ZwCreateFile、 ZwReadFile 或其他類似的作業取代這些函式。

規格需求

需求	值
最低支援的用戶端	支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisOpenFile (NDIS 5.1) ) 。支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisOpenFile (NDIS 5.1) ) 。
目標平台	Universal
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 合規性規則	Irql_Miscellaneous_Function (ndis)