FILE_PIPE_INFORMATION structure (ntifs.h)

  • Article

La structure FILE_PIPE_INFORMATION contient des informations sur un canal nommé qui n’est pas spécifique à l’extrémité locale ou distante du canal.

Syntaxe

typedef struct _FILE_PIPE_INFORMATION {
  ULONG ReadMode;
  ULONG CompletionMode;
} FILE_PIPE_INFORMATION, *PFILE_PIPE_INFORMATION;

Membres

ReadMode

Une des valeurs suivantes.

Valeur Signification
FILE_PIPE_BYTE_STREAM_MODE (0x00000000) Les données sont lues à partir du canal sous la forme d’un flux d’octets.
FILE_PIPE_MESSAGE_MODE (0x00000001) Les données sont lues à partir du canal sous forme de flux de messages.

CompletionMode

Une des valeurs suivantes.

Valeur Signification
FILE_PIPE_QUEUE_OPERATION (0x00000000) Mode de blocage
FILE_PIPE_COMPLETE_OPERATION (0x00000001) Mode non bloquant

Remarques

Si ReadMode est défini sur FILE_PIPE_BYTE_STREAM_MODE, toute tentative de modification doit échouer avec un code d’erreur STATUS_INVALID_PARAMETER.

Lorsque CompletionMode a la valeur FILE_PIPE_QUEUE_OPERATION, si le canal est connecté à, lu ou écrit à partir de, l’opération n’est pas terminée tant qu’il n’y a pas de données à lire, que toutes les données sont écrites ou qu’un client est connecté.

Note La valeur FILE_PIPE_QUEUE_OPERATION pour CompletionMode peut entraîner l’attente indéfinie d’un processus client pour effectuer une action.
 
Lorsque CompletionMode est défini sur FILE_PIPE_COMPLETE_OPERATION, si le canal est connecté, lu ou écrit à partir de, l’opération est terminée immédiatement.

Pour plus d’informations sur les canaux, consultez Canaux.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000
En-tête ntifs.h (include FltKernel.h, Ntifs.h)