Funzione NdisOpenFile (ndis.h)

Articolo
08/07/2023

La funzione NdisOpenFile restituisce un handle per un file aperto.

Sintassi

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

Parametri

[out] Status

Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce lo stato dell'operazione file aperta, che può essere una delle seguenti:

NDIS_STATUS_SUCCESS

L'handle in FileHandle è valido per una chiamata successiva a NdisMapFile.

NDIS_STATUS_FILE_NOT_FOUND

La stringa specificata in FileName non specificava un nome trovato nello spazio dei nomi dell'oggetto di sistema.

NDIS_STATUS_RESOURCES

Non è stato possibile allocare le risorse necessarie per aprire il file e allocare un buffer per il contenuto del file.

NDIS_STATUS_ERROR_READING_FILE

Impossibile leggere i dati del file specificato nella memoria di sistema per l'accesso successivo dal chiamante.

[out] FileHandle

Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce l'handle del file aperto se la chiamata ha esito positivo.

[out] FileLength

Puntatore a una variabile fornita dal chiamante in cui questa funzione scrive il numero di byte di dati nel file aperto se la chiamata ha esito positivo.

[in] FileName

Puntatore a un tipo di NDIS_STRING contenente una stringa conteggiata inizializzata, nel set di caratteri predefinito del sistema, assegnare un nome al file da aprire. Per i driver Windows 2000 e versioni successive, questa stringa contiene caratteri Unicode. Vale a dire, per Windows 2000 e versioni successive, NDIS definisce il tipo NDIS_STRING come tipo di UNICODE_STRING .

[in] HighestAcceptableAddress

L'indirizzo fisico più alto in cui è possibile archiviare i dati del file oppure specifica -1 se il driver non pone restrizioni.

Valore restituito

nessuno

Osservazioni

NdisOpenFile apre un file del disco, in genere un file che verrà scaricato in seguito per programmare una scheda di interfaccia di rete intelligente. NdisOpenFile alloca anche l'archiviazione per contenere il contenuto del file per la chiamata successiva del driver alla funzione NdisMapFile .

Un driver miniport deve chiamare solo NdisOpenFile dalla funzione MiniportInitializeEx .

Quando NdisOpenFile restituisce, il driver miniport può accedere ai dati dei file chiamando NdisMapFile. Può chiamare la funzione NdisUnmapFile per visualizzare la pagina del file in modo da non utilizzare le risorse inutilmente mentre il driver non accede ai dati del file. Al termine dell'uso del file, MiniportInitializeEx deve chiamare il
Funzione NdisCloseFile .

Nota

NdisOpenFile, NdisCloseFile, NdisMapFile e NdisUnmapFile non sono supportati in ARM64. In ARM64 sostituire queste funzioni con chiamate a ZwCreateFile, ZwReadFile o altre operazioni simili.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisOpenFile (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisOpenFile (NDIS 5.1) in Windows XP.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	Irql_Miscellaneous_Function(ndis)