Função WdfRequestWdmFormatUsingStackLocation (wdfrequest.h)

[Aplica-se somente ao KMDF]

O método WdfRequestWdmFormatUsingStackLocation formata uma solicitação de E/S copiando o conteúdo de uma estrutura de local de pilha de E/ S de WDM especificada para o próximo local de pilha na solicitação.

Sintaxe

void WdfRequestWdmFormatUsingStackLocation(
  [in] WDFREQUEST         Request,
  [in] PIO_STACK_LOCATION Stack
);

Parâmetros

[in] Request

Um identificador para um objeto de solicitação de estrutura.

[in] Stack

Um ponteiro para uma estrutura IO_STACK_LOCATION que contém informações fornecidas pelo driver.

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

O método WdfRequestWdmFormatUsingStackLocation copia as informações fornecidas pelo parâmetro Stack para o próximo local da pilha IRP na solicitação.

WdfRequestWdmFormatUsingStackLocation formata a solicitação independentemente de o objeto de destino de E/S da solicitação ser local ou remoto.

Se você quiser definir uma rotina de conclusão para a solicitação, o driver deverá chamar WdfRequestSetCompletionRoutine depois de chamar WdfRequestWdmFormatUsingStackLocation.

Para obter mais informações sobre WdfRequestWdmFormatUsingStackLocation, consulte Encaminhando solicitações de E/S.

Exemplos

O exemplo de código a seguir fornece uma estrutura IO_STACK_LOCATION para uma solicitação de E/S, define uma função de retorno de chamada CompletionRoutine e envia a solicitação para um destino de E/S.

IO_STACK_LOCATION  ioStackLocation;
BOOLEAN sendStatus;
...
//
// Initialize the IO_STACK_LOCATION structure here.
//
...
//
// Assign the IO_STACK_LOCATION structure to the request.
//
WdfRequestWdmFormatUsingStackLocation(
                                      request,
                                      &ioStackLocation
                                      );
//
// Assign a CompletionRoutine callback function.
//
WdfRequestSetCompletionRoutine(
                               Request,
                               RequestTimeoutComplete,
                               NULL
                               );
//
// Send the request.
//
sendStatus = WdfRequestSend(
                            Request,
                            target,
                            NULL
                            );

O exemplo de código a seguir ilustra como enviar um PnP IRP_MN_QUERY_CAPABILITIES IRP para um destino de E/S.

target = WdfDeviceGetIoTarget(Device);
status = WdfRequestCreate(WDF_NO_OBJECT_ATTRIBUTES,
                          target,
                          &request);

if (!NT_SUCCESS(status)) {
    // Log failure and leave
}

//
// PnP IRPs must be initialized with STATUS_NOT_SUPPORTED
//
WDF_REQUEST_REUSE_PARAMS_INIT(&reuse,
                              WDF_REQUEST_REUSE_NO_FLAGS,
                              STATUS_NOT_SUPPORTED);

WdfRequestReuse(request, &reuse);


//
// Initialize device capabilities
//
RtlZeroMemory(Capabilities, sizeof(DEVICE_CAPABILITIES));
Capabilities->Size = sizeof(DEVICE_CAPABILITIES);
Capabilities->Version  =  1;
Capabilities->Address  = (ULONG) -1;
Capabilities->UINumber = (ULONG) -1;
RtlZeroMemory(&stack, sizeof(stack));
stack.MajorFunction = IRP_MJ_PNP;
stack.MinorFunction = IRP_MN_QUERY_CAPABILITIES;
stack.Parameters.DeviceCapabilities.Capabilities = Capabilities;

WdfRequestWdmFormatUsingStackLocation(request, &stack);

WDF_REQUEST_SEND_OPTIONS_INIT(&options,
                              WDF_REQUEST_SEND_OPTION_SYNCHRONOUS);

if (WdfRequestSend(request, target, &options) == FALSE) {
    // Log failure
}

status = WdfRequestGetStatus(request);

if (!NT_SUCCESS(status)) {
    // Log failure
}

// Remember to delete the WDFREQUEST after creating it
if (request != NULL) {
    WdfObjectDelete(request);
}

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Cabeçalho	wdfrequest.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL	<=DISPATCH_LEVEL
Regras de conformidade da DDI	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), RequestFormattedValid(kmdf)

Confira também

WdfRequestSetCompletionRoutine