Função FsRtlSetEcpListIntoIrp (ntifs.h)

  • Artigo

A rotina FsRtlSetEcpListIntoIrp anexa uma lista de estruturas de contexto ECP (parâmetro de criação extra) a uma operação de IRP_MJ_CREATE.

Sintaxe

NTSTATUS FsRtlSetEcpListIntoIrp(
  [in, out] PIRP      Irp,
  [in]      PECP_LIST EcpList
);

Parâmetros

[in, out] Irp

Um ponteiro para o IRP para uma operação de IRP_MJ_CREATE à qual a lista de estrutura de contexto do ECP deve ser anexada.

[in] EcpList

Ponteiro para uma lista de ECP que contém uma ou mais estruturas de contexto ECP. Essas estruturas serão anexadas ao IRP ao qual o parâmetro Irp aponta.

Retornar valor

FsRtlSetEcpListIntoIrp retorna um dos seguintes valores NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
 A lista de ECP fornecida foi anexada com êxito ao IRP especificado.
STATUS_INVALID_PARAMETER_2
 O IRP especificado não era uma operação de IRP_MJ_CREATE baseada em IRP.
STATUS_INVALID_PARAMETER_3
 Uma lista de ECP já foi anexada ao IRP especificado.

Comentários

A rotina FsRtlSetEcpListIntoIrp fornece um mecanismo para passar parâmetros de criação extra para baixo na pilha de filtros do sistema de arquivos para drivers de filtro subjacentes.

Para recuperar uma lista de ECP associada a uma determinada operação de IRP_MJ_CREATE, use a rotina FsRtlGetEcpListFromIrp .

Requisitos

Requisito Valor
Cliente mínimo com suporte FsRtlSetEcpListIntoIrp está disponível a partir do Windows Vista.
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Confira também

ECP_LIST

FsRtlGetEcpListFromIrp