IRP_MJ_CREATE_MAILSLOT等位的 FLT_PARAMETERS

發行項
02/02/2024

當FLT_IO_PARAMETER_BLOCK 結構的 MajorFunction 字段IRP_MJ_CREATE_MAILSLOT時，會使用FLT_PARAMETERS等位內的下列結構。

語法

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

成員

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

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

備註

當 I/O 作業IRP_MJ_CREATE_MAILSLOT時，FLT_PARAMETERS包含 CreateMailslot 結構。 I/O 作業是以FLT_CALLBACK_DATA結構表示，而作業參數包含在回呼數據的 Iopb 參數指向的FLT_IO_PARAMETER_BLOCK結構內。

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

請注意，除了最後一個longword欄位以外， CreateMailslot 結構中的字段必須符合 Create 結構的欄位。

IRP_MJ_CREATE_MAILSLOT是以 IRP 為基礎的作業。