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
Header	ntifs.h (FltKernel.h、Ntifs.h を含む)