Função de retorno de chamada PFNAVCINTERSECTHANDLER (avc.h)

  • Artigo

O manipulador de intersecção AV/C determina se os intervalos de dados são compatíveis. Essa é uma função definida pelo usuário com base no seguinte protótipo:

Sintaxe

typedef NTSTATUS ( *PFNAVCINTERSECTHANDLER)(
  _In_      PVOID        Context,
  _In_      ULONG        PinId,
  _In_      PKSDATARANGE CallerDataRange,
  _In_      PKSDATARANGE DescriptorDataRange,
  _In_      ULONG        DataBufferSize,
  _Out_opt_ PVOID        Data,
  _Out_     PULONG       ReportedDataSize
);

Parâmetros

[in] Context

Um valor opcional esperado pelo manipulador de interseção. Esse valor é fornecido pelo driver de subunidade (se o driver de subunidade fornecer o manipulador de interseção) ou pelo driver inferior que fornece o manipulador de interseção.

[in] PinId

Especifica o deslocamento (ou ID) do pino para o qual a interseção está sendo feita.

[in] DataRange

[in] MatchingDataRange

[in] DataBufferSize

O tamanho do buffer passado pelo membro Dados . Se isso for diferente de zero, o manipulador de interseção deverá tentar retornar o formato de dados resultante de um par correspondente de intervalos de dados. Se for zero, o manipulador intersect deverá fornecer o tamanho do buffer necessário em ReportedDataSize e retornar STATUS_BUFFER_OVERFLOW.

[out, optional] Data

Um buffer opcional para receber o formato de dados resultante de um par correspondente de intervalos de dados. Esse membro será ignorado se DataBufferSize for zero.

[out] DataSize

Retornar valor

O manipulador de interseção deve retornar STATUS_SUCCESS se os intervalos de dados forem compatíveis e houver espaço de buffer suficiente para retornar o formato resultante.

Código de retorno Descrição
STATUS_NO_MATCH Os intervalos de dados não são compatíveis.
STATUS_INTERNAL_ERROR Houve uma incompatibilidade de tamanho de formato inesperada.
STATUS_BUFFER_OVERFLOW O manipulador intersect retorna o tamanho do buffer necessário por meio do membro ReportedDataSize .
STATUS_BUFFER_TOO_SMALL O manipulador de intersecção não foi fornecido com um buffer grande o suficiente para manter o formato resultante. O manipulador de intersecção deve ser chamado novamente com o DataBufferSize definido como zero para determinar o tamanho do buffer necessário.
STATUS_INSUFFICIENT_RESOURCES Falha na alocação de buffer interno.

Comentários

O manipulador de interseção AV/C é definido pelo usuário, com base no protótipo de função acima.

O manipulador é usado em conjunto com o código da função AVC_FUNCTION_GET_PIN_DESCRIPTOR . A finalidade do manipulador é corresponder a formatos de dados de pino idênticos e retorná-los ao chamador.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho avc.h (inclua Avc.h)

Confira também