AVCSTRM_GET_STATE

Artigo
06/15/2023

O código da função AVCSTRM_GET_STATE obtém o estado de fluxo atual do fluxo especificado.

Bloco de Status de E/S

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

Se tiver êxito, um STATUS_SUCCESS será retornado. O membro StreamState da união CommandData tem o estado de fluxo atual. Pode ser KSSTATE_STOP, KSTATE_PAUSE ou KSSTATE_RUN.

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_GET_STATE no argumento Solicitação da macro.

AVCStreamContext
Especifica o contexto de fluxo (identificador) retornado por uma chamada AVCSTRM_OPEN anterior para obter o estado do fluxo.

StreamState
Se AVCSTRM_GET_STATE retornar com êxito, esse membro conterá o estado do fluxo atual.

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 do qual obter o estado do 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;