NdisOpenFile, fonction (ndis.h)

Article
02/26/2024

La fonction NdisOpenFile retourne un handle pour un fichier ouvert.

Syntaxe

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

Paramètres

[out] Status

Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne le status de l’opération d’ouverture de fichier, qui peut être l’une des suivantes :

NDIS_STATUS_SUCCESS

Le handle dans FileHandle est valide pour un appel ultérieur à NdisMapFile.

NDIS_STATUS_FILE_NOT_FOUND

La chaîne donnée dans FileName n’a pas spécifié de nom trouvé dans l’espace de noms de l’objet système.

NDIS_STATUS_RESOURCES

NDIS n’a pas pu allouer les ressources nécessaires pour ouvrir le fichier et allouer une mémoire tampon pour le contenu du fichier.

NDIS_STATUS_ERROR_READING_FILE

Les données du fichier spécifié n’ont pas pu être lues dans la mémoire système pour un accès ultérieur par l’appelant.

[out] FileHandle

Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne le handle du fichier ouvert si l’appel réussit.

[out] FileLength

Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction écrit le nombre d’octets de données dans le fichier ouvert si l’appel réussit.

[in] FileName

Pointeur vers un type NDIS_STRING contenant une chaîne comptée initialisée, dans le jeu de caractères par défaut du système, nommant le fichier à ouvrir. Pour les pilotes Windows 2000 et versions ultérieures, cette chaîne contient des caractères Unicode. Autrement dit, pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING comme un type UNICODE_STRING .

[in] HighestAcceptableAddress

Adresse physique la plus élevée dans laquelle les données de fichier peuvent être stockées, ou spécifie -1 si le pilote n’applique aucune restriction.

Valeur de retour

None

Remarques

NdisOpenFile ouvre un fichier de disque, généralement un fichier que le pilote téléchargera ultérieurement pour programmer une carte réseau intelligente. NdisOpenFile alloue également du stockage pour stocker le contenu du fichier pour l’appel ultérieur du pilote à la fonction NdisMapFile .

Un pilote miniport doit appeler NdisOpenFile uniquement à partir de la fonction MiniportInitializeEx .

Lorsque NdisOpenFile est retourné, le pilote miniport peut accéder aux données de fichier en appelant NdisMapFile. Il peut appeler la fonction NdisUnmapFile pour paginer le fichier afin qu’il ne consomme pas inutilement des ressources pendant que le pilote n’accède pas aux données du fichier. Lorsque vous avez terminé d’utiliser le fichier, MiniportInitializeEx doit appeler le
Fonction NdisCloseFile .

Notes

NdisOpenFile, NdisCloseFile, NdisMapFile et NdisUnmapFile ne sont pas pris en charge sur ARM64. Sur ARM64, remplacez ces fonctions par des appels à ZwCreateFile, ZwReadFile ou d’autres opérations similaires.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisOpenFile (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisOpenFile (NDIS 5.1)) dans Windows XP.
Plateforme cible	Universal
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Miscellaneous_Function(ndis)