estrutura STATUS_BLOCK (video.h)

  • Artigo

A estrutura STATUS_BLOCK é uma subestrutura dentro da estrutura VIDEO_REQUEST_PACKET. A função HwVidStartIO de um driver de miniporto deve definir o bloco status de cada VRP que ele obtém.

Sintaxe

typedef struct _STATUS_BLOCK {
  union {
    VP_STATUS Status;
    PVOID     Pointer;
  };
  ULONG_PTR Information;
} STATUS_BLOCK, *PSTATUS_BLOCK;

Membros

Status

Indica o resultado da operação solicitada. Esse membro pode ser um dos seguintes códigos de status:

ERROR_INSUFFICIENT_BUFFER

O InputBuffer vrp é muito pequeno para fornecer os dados necessários para processar a solicitação fornecida ou o OutputBuffer é muito pequeno para retornar os dados solicitados.

ERROR_INVALID_FUNCTION

O driver de miniporta não lida com essa solicitação.

ERROR_INVALID_PARAMETER

Um parâmetro no VRP é inválido.

ERROR_IO_PENDING

Uma operação ainda não foi concluída.

ERROR_MORE_DATA

O driver tem dados adicionais a serem retornados, mas já preencheu o OutputBuffer vrp especificado.

ERROR_NOT_ENOUGH_MEMORY

Não há memória suficiente para processar a solicitação.

NO_ERROR

A operação solicitada foi realizada e concluída com êxito.

Pointer

Deve ser ignorado pelo driver de miniporta. Esse membro da união existe para garantir o alinhamento de campo entre sistemas de 32 e 64 bits.

Information

Fornece informações adicionais sobre a operação concluída. O significado do valor varia de acordo com VRP. Geralmente, esse membro é usado para retornar o tamanho mínimo necessário para o buffer de entrada se o VRP passar dados no InputBuffer. Como alternativa, ele conterá o número de bytes de dados transferidos se a operação solicitada retornar dados no OutputBuffer do VRP.

Requisitos

Requisito Valor
Cabeçalho video.h (incluir Video.h)

Confira também

HwVidStartIO

VIDEO_REQUEST_PACKET