FILE_PIPE_INFORMATION構造体 (ntifs.h)

FILE_PIPE_INFORMATION 構造体には、パイプのローカルまたはリモートの端に固有ではない名前付きパイプに関する情報が含まれています。

構文

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

ReadMode

次のいずれかの値。

価値	意味
FILE_PIPE_BYTE_STREAM_MODE (0x00000000)	データは、バイトストリームとしてパイプから読み取られます。
FILE_PIPE_MESSAGE_MODE (0x00000001)	データは、メッセージのストリームとしてパイプから読み取られます。

CompletionMode

次のいずれかの値。

価値	意味
FILE_PIPE_QUEUE_OPERATION (0x00000000)	ブロックモード
FILE_PIPE_COMPLETE_OPERATION (0x00000001)	非ブロッキングモード

ReadMode が FILE_PIPE_BYTE_STREAM_MODE に設定されている場合、変更を試みると、STATUS_INVALID_PARAMETERエラーコードで失敗する必要があります。

CompletionMode がFILE_PIPE_QUEUE_OPERATIONに設定されている場合、パイプが接続、読み取り、または書き込まれた場合、読み取るデータ、すべてのデータが書き込まれる、またはクライアントが接続されるまで、操作は完了しません。

メモCompletionMode の値がFILE_PIPE_QUEUE_OPERATIONの場合、クライアントプロセスがアクションを実行するのを無期限に待機する可能性があります。

CompletionMode がFILE_PIPE_COMPLETE_OPERATIONに設定されている場合、パイプが接続、読み取り、または書き込み中の場合、操作はすぐに完了します。

パイプの詳細については、「パイプ」を参照してください。

要件	価値
サポートされる最小クライアント	Windows 2000
ヘッダー	ntifs.h (FltKernel.h、Ntifs.h を含む)