Função FsRtlSetEcpListIntoIrp (ntifs.h)

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 estruturas de contexto ECP deve ser anexada.

[in] EcpList

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

Valor de retorno

FsRtlSetEcpListIntoIrp retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	A lista 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 ECP já foi anexada ao IRP especificado.

Observações

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

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

Requisitos

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

Consulte também

ECP_LIST

FsRtlGetEcpListFromIrp