Função ChangerGetProductData (mcd.h)
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 |