Função ChangerGetParameters (mcd.h)

ChangerGetParameters manipula os aspectos específicos do dispositivo de um IRP de controle de dispositivo com o código IOCTL IOCTL_CHANGER_GET_PARAMETERS.

Sintaxe

NTSTATUS ChangerGetParameters(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

Parâmetros

[in] DeviceObject

Ponteiro para o objeto do dispositivo que representa o alterador.

[in] Irp

Ponteiro para o IRP.

Retornar valor

ChangerGetParameters retorna o valor STATUS_XXX retornado pelo driver de porta do sistema ou um dos seguintes valores:

STATUS_SUCCESS

STATUS_INFO_LENGTH_MISMATCH

STATUS_INSUFFICIENT_RESOURCES

Comentários

Essa rotina é necessária.

ChangerGetParameters retorna os parâmetros de um alterador, incluindo o número e o tipo de seus elementos e a funcionalidade que ele dá suporte.

O driver de classe do alterador verifica o comprimento do buffer de saída no local da pilha de E/S antes de chamar ChangerGetParameters. Se o comprimento do buffer de saída for menor que sizeof(GET_CHANGER_PARAMETERS), o driver de classe do alterador retornará com um valor de STATUS_INFO_LENGTH_MISMATCH.

ChangerGetParameters recupera dados de parâmetro do dispositivo criando SRBs com CDBs para obter a página de cabeçalho do parâmetro SCSI, a página de endereço do elemento, a página de geometria de transporte e a página de recursos do dispositivo ou o equivalente não SCSI desses dados.

ChangerGetParameters preenche uma estrutura de GET_CHANGER_PARAMETERS em Irp-AssociatedIrp.SystemBuffer> antes de retornar ao driver de classe do alterador.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	mcd.h (include Mcd.h, Ntddchgr.h)
IRQL	PASSIVE_LEVEL

Confira também

GET_CHANGER_PARAMETERS

IOCTL_CHANGER_GET_PARAMETERS