Compartilhar via

Função AcxStreamDispatchAcxRequest (acxstreams.h)

  • Artigo

O AcxStreamDispatchAcxRequest despacha uma solicitação ACX usando um objeto de solicitação de estrutura WDFREQUEST. AcxStreamDispatchAcxRequest é chamado no contexto de um manipulador de eventos EVT_ACX_OBJECT_PREPROCESS_REQUEST registrado por meio de AcxStreamInitAssignAcxRequestPreprocessCallback para indicar que a solicitação deve ser tratada pela estrutura ACX.

Sintaxe

NTSTATUS AcxStreamDispatchAcxRequest(
  ACXSTREAM  Stream,
  WDFREQUEST Request
);

Parâmetros

Stream

Um objeto ACXSTREAM existente. Um objeto ACXSTREAM representa um fluxo de áudio criado por um circuito. Para obter mais informações, consulte ACX – Resumo de objetos ACX.

Request

O identificador de objeto WDFREQUEST que foi passado para o manipulador de eventos EVT_ACX_OBJECT_PREPROCESS_REQUEST . Para obter informações gerais sobre solicitações do WDF, consulte Criando objetos de solicitação de estrutura.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Para qualquer chamada à EVT_ACX_OBJECT_PREPROCESS_REQUEST do driver para um objeto AcxStream, o driver deve chamar WdfRequestComplete ou AcxStreamDispatchAcxRequest, mas não ambos.

Exemplo

O uso de exemplo é mostrado abaixo.

VOID
Codec_EvtStreamRequestPreprocess(
    _In_    ACXOBJECT  Object,
    _In_    ACXCONTEXT DriverContext,
    _In_    WDFREQUEST Request
    )
/*++

Routine Description:

    This function is an example of a preprocess routine.

--*/
{
    //
    // Just give the request back to ACX. Normally the driver would take steps to examine
    // the Request and take action if necessary.
    //
    AcxStreamDispatchAcxRequest((ACXSTREAM)Object, Request);
}

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre as versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxstreams.h
IRQL PASSIVE_LEVEL

Confira também