Função ChangerGetProductData (mcd.h)

  • Artigo

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

Sintaxe

NTSTATUS ChangerGetProductData(
  [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

ChangerGetProductData sempre retorna STATUS_SUCCESS.

Comentários

Essa rotina é necessária.

ChangerGetProductData retorna dados do produto para um alterador.

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

ChangerGetProductData preenche uma estrutura de CHANGER_PRODUCT_DATA em Irp-AssociatedIrp.SystemBuffer> antes de retornar ao driver de classe do alterador. Se o driver de miniclasse tiver armazenado em cache dados de consulta na extensão de dispositivo do alterador antes de retornar do ChangerInitialize, todos os membros, exceto DeviceType , poderão ser preenchidos com base nesses dados.

Requisitos

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

Confira também

CHANGER_PRODUCT_DATA

ChangerInitialize