DXGKCB_AGP_SET_COMMAND função de retorno de chamada (dispmprt.h)
A função AgpSetCommand define a taxa de AGP e especifica se o endereçamento de banda lateral e as transações de gravação rápida estão habilitados.
Sintaxe
DXGKCB_AGP_SET_COMMAND DxgkcbAgpSetCommand;
NTSTATUS DxgkcbAgpSetCommand(
[in] HANDLE Context,
[in] ULONG Command
)
{...}
Parâmetros
[in] Context
Um identificador para um bloco de contexto associado a uma interface AGP. O driver de miniporto de exibição recebeu anteriormente esse identificador no membro Context da estrutura DXGK_AGP_INTERFACE que foi preenchida por DxgkCbQueryServices.
[in] Command
Um conjunto de sinalizadores que especificam a taxa de AGP e os tipos de transações AGP que serão usadas.
O chamador deve definir um e apenas um dos sinalizadores a seguir.
| Sinalizador | Significado |
|---|---|
| DXGK_AGPCOMMAND_AGP1X | A taxa de transferência do AGP é 1X. |
| DXGK_AGPCOMMAND_AGP2X | A taxa de transferência do AGP é 2X. |
| DXGK_AGPCOMMAND_AGP4X | A taxa de transferência do AGP é 4X. |
| DXGK_AGPCOMMAND_AGP8X | A taxa de transferência do AGP é 8X. |
O chamador também pode optar por definir ou limpar os sinalizadores a seguir.
| Sinalizador | Significado |
|---|---|
| DXGK_AGPCOMMAND_DISABLE_SBA | Se esse sinalizador estiver definido, o endereçamento de banda lateral será desabilitado. Se esse sinalizador estiver limpo, o endereçamento de banda lateral estará habilitado. |
| DXGK_AGPCOMMAND_DISABLE_FW | Se esse sinalizador estiver definido, as transações de gravação rápida serão desabilitadas. Se esse sinalizador for limpo, as transações de gravação rápida serão habilitadas. Observe que as transações de gravação rápida não podem ser usadas com o AGP1X. |
Retornar valor
AgpSetCommand retornará STATUS_SUCCESS se for bem-sucedido. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.
Comentários
Nenhum.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |