AVCSTRM_SET_STATE

Artigo
06/14/2023

O código da função AVCSTRM_SET_STATE coloca o fluxo especificado em um novo estado de fluxo.

Bloco de Status de E/S

Se tiver êxito, avcstrm.sysdefinirá Irp-IoStatus.Status> como STATUS_SUCCESS.

Os possíveis valores retornados por erro incluem:

Status do erro	Descrição
STATUS_DEVICE_REMOVED	O dispositivo correspondente à operação de AVCSTRM_READ não existe mais.
STATUS_CANCELLED	A solicitação não pôde ser concluída.
STATUS_INVALID_PARAMETER	Um parâmetro especificado no IRP está incorreto.
STATUS_INSUFFICIENT_RESOURCES	Não havia recursos suficientes do sistema para concluir a solicitação.
STATUS_PENDING	A solicitação foi recebida, mas requer processamento adicional. A rotina de conclusão de E/S lidará com a resposta final.

Entrada AVC_STREAM_REQUEST_BLOCK

SizeOfThisBlock, Versão e Função
Use a macro INIT_AVCSTRM_HEADER para inicializar esses membros. Passe AVCSTRM_SET_STATE no argumento Solicitação da macro.

AVCStreamContext
Especifica o contexto de fluxo (identificador) retornado por uma chamada AVCSTRM_OPEN anterior a ser colocada em um novo estado de fluxo.

StreamState
Especifica o novo estado de fluxo no qual colocar o fluxo.

Um driver de subunidade deve primeiro alocar um IRP e uma estrutura de AVC_STREAM_REQUEST_BLOCK .

Em seguida, ele deve usar a macro INIT_AVCSTRM_HEADER para inicializar a estrutura AVC_STREAM_REQUEST_BLOCK, passando AVCSTRM_GET_STATE como o argumento Request para a macro.

Em seguida, o driver de subunidade define o membro AVCStreamContext como o contexto de fluxo (identificador) do fluxo do qual obter o estado do fluxo.

Para enviar essa solicitação, uma subunidade envia um IRP IRP_MJ_INTERNAL_DEVICE_CONTROL com o membro IoControlCode do IRP definido como IOCTL_AVCSTRM_CLASS e o membro Argument1 do IRP definido para a estrutura AVC_STREAM_REQUEST_BLOCK que descreve o fluxo a ser colocado em um novo estado de fluxo.

Um driver de subunidade pode esperar que esse comando seja concluído de forma síncrona. O resultado retorna imediatamente sem operação pendente no avcstrm.sys.

Esse código de função deve ser chamado em IRQL = PASSIVE_LEVEL.

Comentários

Essa função usa o membro StreamState da união CommandData na estrutura AVC_STREAM_REQUEST_BLOCK, conforme mostrado abaixo.

typedef struct _AVC_STREAM_REQUEST_BLOCK {
  ULONG  SizeOfThisBlock;
  ULONG  Version;
  AVCSTRM_FUNCTION  Function;
  .
  .
  PVOID AVCStreamContext;
  .
  .
  union _tagCommandData {
    .
    .
    KSSTATE  StreamState;
    .
    .
  } CommandData;
} AVC_STREAM_REQUEST_BLOCK, *PAVC_STREAM_REQUEST_BLOCK;