IRP_MJ_CREATE_NAMED_PIPE等位FLT_PARAMETERS

發行項
02/02/2024

當FLT_IO_PARAMETER_BLOCK結構的 MajorFunction 欄位IRP_MJ_CREATE_NAMED_PIPE時，會使用FLT_PARAMETERS等位內的下列結構。

語法

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    PIO_SECURITY_CONTEXT     SecurityContext;
    ULONG                    Options;
    USHORT POINTER_ALIGNMENT Reserved;
    USHORT                   ShareAccess;
    PVOID                    Parameters;
  } CreatePipe;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

成員

FLT_PARAMETERS的 CreatePipe 結構包含下列成員。

SecurityContext：代表IRP_MJ_CREATE_NAMED_PIPE 要求之安全性內容的IO_SECURITY_CONTEXT結構的指標，其中：
SecurityContext->AccessState 是 ACCESS_STATE 結構的指標，其中包含對象的主體內容、授與的存取類型，以及剩餘所需的存取類型。
SecurityContext->DesiredAccess 是一個ACCESS_MASK 結構，指定為命名管道所要求的訪問許可權。如需詳細資訊，請參閱 FltCreateNamedPipeFile 的 DesiredAccess 參數。
選項：旗標的位掩碼，指定建立或開啟命名管道時要套用的選項，以及管道已經存在時要採取的動作。此成員的低 24 位會對應至 FltCreateNamedPipeFile 的 CreateOptions 參數。高 8 位對應至 FltCreateNamedPipeFile 的 CreateDisposition 參數。
保留：保留;請勿使用。
ShareAccess：針對命名管道檔案要求之共用訪問許可權的位掩碼。如果此參數為零，則會要求獨佔存取權。如需詳細資訊，請參閱 FltCreateNamedPipeFile 的 ShareAccess 參數。
參數：指向NAMED_PIPE_CREATE_PARAMETERS 結構的指標，其中包含所建立或開啟之命名管道的相關信息。

備註

當 I/O 作業IRP_MJ_CREATE_NAMED_PIPE時，FLT_PARAMETERS包含 CreatePipe 結構。 I/O 作業是以FLT_CALLBACK_DATA結構來表示，其中包含回呼數據 Iopb 參數所指向之FLT_IO_PARAMETER_BLOCK結構中的作業參數。

已為IRP_MJ_CREATE_NAMED_PIPE作業註冊回呼例程的文件系統迷你篩選驅動程式應該執行任何必要的處理並傳回。

請注意，除了最後一個長word 欄位以外， CreatePipe 結構中的欄位必須符合 Create 結構的欄位。

IRP_MJ_CREATE_NAMED_PIPE是以 IRP 為基礎的作業。