Rotina MRxDevFcbXXXControlFile
A rotina MRxDevFcbXXXControlFile é chamada pelo RDBSS para passar uma solicitação de controle FCB do dispositivo (uma solicitação IOCTL ou FSCTL) para o minidiretório de rede.
Sintaxe
PMRX_CALLDOWN MRxDevFcbXXXControlFile;
NTSTATUS MRxDevFcbXXXControlFile(
_Inout_ PRX_CONTEXT RxContext
)
{ ... }
Parâmetros
RxContext [in, out]
Um ponteiro para a estrutura RX_CONTEXT. Esse parâmetro contém o IRP que está solicitando a operação.
Retornar valor
MRxDevFcbXXControlFile retorna STATUS_SUCCESS com êxito ou um valor NTSTATUS apropriado, como um dos seguintes:
| Código de retorno | Descrição |
|---|---|
| STATUS_ACCESS_DENIED | Foi feita uma solicitação para parar ou iniciar o minidiretório de rede, mas o chamador não tinha a segurança adequada para essa operação. |
| STATUS_INVALID_DEVICE_REQUEST | Uma solicitação de dispositivo inválida foi enviada para o minidiretório de rede. |
| STATUS_REDIRECTOR_HAS_OPEN_HANDLES | Essa foi uma solicitação para interromper o minidiretório de rede, mas o redirecionador tem identificadores abertos que impedem que ele pare no momento. |
| STATUS_REDIRECTOR_NOT_STARTED | Essa foi uma solicitação para interromper o minidiretório de rede, mas o redirecionador não foi iniciado. |
| STATUS_REDIRECTOR_STARTED | Essa foi uma solicitação para iniciar o minidiretório de rede, mas o redirecionador já foi iniciado. |
Comentários
MRxDevFcbXXXControlFile manipula solicitações IOCTL e FSCTL relacionadas ao FCB do dispositivo que são enviadas para o minidiretório de rede.
Antes de chamar MRxDevFcbXXXControlFile, o RDBSS modifica o seguinte membro na estrutura RX_CONTEXT apontada pelo parâmetro RxContext :
MajorFunction é definido como a função principal do IRP
Se essa fosse uma solicitação IRP_MJ_FILE_SYSTEM_CONTROL, o RDBSS modificará os seguintes membros na estrutura RX_CONTEXT apontada pelo parâmetro RxContext :
LowIoContext.ParamsFor.FsCtl.MinorFunction é definido como o código de função secundária para o código FSCTL
LowIoContext.ParamsFor.FsCtl.FsControlCode é definido como o código FSCTL para o IRP
Se essa for uma solicitação IRP_MJ_DEVICE_CONTROL ou IRP_MJ_INTERNAL_DEVICE_CONTROL, o RDBSS modificará o seguinte membro na estrutura RX_CONTEXT apontada pelo parâmetro RxContext :
LowIoContext.ParamsFor.FsCtl.FsControlCode é definido como o código de controle do IRP.
Se MRxDevFcbXXXControlFile retornar STATUS_SUCCESS, a rotina foi bem-sucedida. Qualquer outro valor retornado indica que ocorreu um erro.
Requisitos
Plataforma de destino |
Área de Trabalho |
parâmetro |
Mrx.h (inclua Mrx.h) |