IOCTL _ 디스크가 _ _ 볼륨 _ 준비 컨트롤 코드입니다.IOCTL_DISK_ARE_VOLUMES_READY control code

지정 된 디스크의 모든 볼륨을 사용할 준비가 될 때까지 기다립니다.Waits for all volumes on the specified disk to be ready for use.

이 작업을 수행 하려면 다음 매개 변수를 사용 하 여 DeviceIoControl 함수를 호출 합니다.To perform this operation, call the DeviceIoControl function with the following parameters.

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device 
                 IOCTL_DISK_ARE_VOLUMES_READY,   // dwIoControlCode
                 (LPVOID)       NULL,            // lpInBuffer 
                 (DWORD)        0,               // nInBufferSize 
                 (LPVOID)       NULL,            // lpOutBuffer 
                 (DWORD)        0,               // nOutBufferSize
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

매개 변수Parameters

hDevicehDevice

디스크에 대 한 핸들입니다.A handle to the disk.

장치 핸들을 검색 하려면 CreateFile 함수를 호출 합니다.To retrieve a device handle, call the CreateFile function.

dwIoControlCodedwIoControlCode

작업에 대 한 컨트롤 코드입니다.The control code for the operation.

이 작업에 사용할 _ _ 수 있는 볼륨은 IOCTL 디스크를 _ _ 사용 하 여 준비 됩니다.Use IOCTL_DISK_ARE_VOLUMES_READY for this operation.

lpInBufferlpInBuffer

이 작업에는 사용 되지 않습니다.Not used with this operation. NULL 로 설정 합니다.Set to NULL.

nInBufferSizenInBufferSize

입력 버퍼의 크기 (바이트)입니다.The size of the input buffer, in bytes. 0으로 설정 합니다.Set to 0 (zero).

lpOutBufferlpOutBuffer

이 작업에는 사용 되지 않습니다.Not used with this operation. NULL 로 설정 합니다.Set to NULL.

nOutBufferSizenOutBufferSize

이 작업에는 사용 되지 않습니다.Not used with this operation. 0으로 설정 합니다.Set to 0 (zero).

lpBytesReturnedlpBytesReturned

이 작업에는 사용 되지 않습니다.Not used with this operation. NULL 로 설정 합니다.Set to NULL.

lpOverlappedlpOverlapped

겹쳐진 구조체에 대 한 포인터입니다.A pointer to an OVERLAPPED structure.

파일 _ 플래그를 _ 겹쳐 지정 하지 않고 hdevice 를 연 경우 lpOverlapped 은 무시 됩니다.If hDevice was opened without specifying FILE_FLAG_OVERLAPPED, lpOverlapped is ignored.

파일 _ 플래그 _ 겹치는 플래그를 사용 하 여 hdevice 를 연 경우 작업은 겹치는 (비동기) 작업으로 수행 됩니다.If hDevice was opened with the FILE_FLAG_OVERLAPPED flag, the operation is performed as an overlapped (asynchronous) operation. 이 경우 lpOverlapped 는 이벤트 개체에 대 한 핸들을 포함 하는 유효한 겹쳐진 구조체를 가리켜야 합니다.In this case, lpOverlapped must point to a valid OVERLAPPED structure that contains a handle to an event object. 그렇지 않으면 함수가 예측할 수 없는 방식으로 실패 합니다.Otherwise, the function fails in unpredictable ways.

겹쳐진 작업의 경우 DeviceIoControl 는 즉시 반환 되 고 작업 완료 시 이벤트 개체는 신호를 받았습니다.For overlapped operations, DeviceIoControl returns immediately, and the event object is signaled when the operation has been completed. 그렇지 않으면 작업이 완료 되거나 오류가 발생할 때까지 함수가 반환 되지 않습니다.Otherwise, the function does not return until the operation has been completed or an error occurs.

반환 값Return value

작업이 성공적으로 완료 되 면 디스크의 모든 볼륨을 사용할 준비가 되었음을 나타내는 DeviceIoControl 은 0이 아닌 값을 반환 합니다.If the operation completes successfully, indicating that all volumes on the disk are ready for use, DeviceIoControl returns a nonzero value.

작업이 실패 하거나 보류 중인 경우 DeviceIoControl 는 0을 반환 합니다.If the operation fails or is pending, DeviceIoControl returns zero. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.To get extended error information, call GetLastError.

요구 사항Requirements

요구 사항Requirement Value
지원되는 최소 클라이언트Minimum supported client
Windows 8 [ 데스크톱 앱에만 해당]Windows 8 [desktop apps only]
지원되는 최소 서버Minimum supported server
Windows Server 2012 [ 데스크톱 앱에만 해당]Windows Server 2012 [desktop apps only]
헤더Header
Ntdddisk .h
Ntdddisk.h

참고 항목See also

DeviceIoControlDeviceIoControl

디스크 관리 제어 코드Disk Management Control Codes