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 の値を指定すると、クライアント プロセスがアクションを実行するまで無期限に待機する可能性があります。
パイプの詳細については、「 パイプ」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 |
Header | ntifs.h (FltKernel.h、Ntifs.h を含む) |